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PREFACE 


This manual is intended for the person who is charged with 
configuring the GCOS A MOD 400 system software to meet the 
characteristics and requirements of his installation site. This 
oerson is assumed to he well acquainted with the GCoS 6 MOD 400 
Executive and with CII HONEYrfELL Bill's Series bO (Mini 6) 
minicomputer systems. In addition, this person is assumed to have 
read the System Concepts manua1 . and if he intends to buiId a system 
sunporting communications devices, the Common leations Processtnq 
manual. The Manual Director/ at the beginning of this manual lists 
the titles and orders numbers of oertlnent documents. 

This publication describes In detail the orocedures necessary to 
build the system, the system building directives from which the 
MOD 4)0 Executive is assembled, and the utility programs used in the 
building process. 

Section I of this manual introduces the subject of system hui ldi.og 
and oriefly describes the contents of the document. 


Section II outlines information the s/stem builder must gather prior 
to configuring a system to his specifications. 

Section III describes the tor*e stages of syste i startup and the 
purpose of each stage. SectLon III also describes the ooerato^'s and 
the system's actions during system startuo, 

Section IV describes how to use the Interactive GLM directive 
generation program, M4_5YSDEF. 

The information and soeclflcations in this document are subject to 
change without notice. This document cont a i ns Inforns tion abou t 
CII HONEYWELL BJLL products or services that may not he available in 
all countries. Consult your CII HONEYWELL BULL Marketing 
Reoresentative. 


Section V describes in detail the noncommunications directives that 
are processed by the Conflouratinn Load Manager a system software 
tool — as it configures the system to stipulated speclfications. 

Section VI describes communications-relsted directives processed by 
the Configuration Load Manager. . , 

Section VII lists the contents of the system disks on which GCOS 6 
MOD 400 and other related software conpo.ients are available. 
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Section VIII Includes a number of miscellaneous but Important 
technical notes, most of which oertain only to certain installation 
sites. This section should be read before attempting to use the 
system. 

Aopendix A presents an overview of the various types of halts 
oossiole durinj system startup. 

Appendix B lists the names and approximate sizes of all system 
overlays, which may be used as overlays or, where optimum speed Is 
desired for the related function, selectively made permanently 
resident In memory. 

AopenJlx C contains minimum system guidelines and a list of 
s upport ed equipment. 

Appendix D describes configuration considerations relative to the 
Power Resumption Facility. 

Aopendix £ deals with configuration information (including linking) 
pertaining to the Data Entry Facility. 

Appendix F describes configuration information for the Remote Batch 
Facility. 

Appendix G presents configuration information relative to the file 
transmission capability. 

Appendix H and Appendix J provide configuration information 
pertaining to I3M workstation Facilities. 

Appendix K oresents configuration Information for the Programmable 
Faci 11 ty/32 7) . 


Appendix L describes installation and activation of the Listener and 
Login caoability. 


Anoendlx M orovldes a handy checklist for use with the W4„SYSDEF 
interactive CLM directive generation orogram. 

Anoendlx N provides configuration information for the error logging 
capaoi1ity. 

Appendix P provides configuration information for the Display 
Formatting and Control software. 


Appendix R provides configuration Information for the Asynchronous 
Character Terminal Driver. 


After reading this manual, the user should be able to build, the 
system for initial operation and onsite oersonnel training, and 
rebuild the system later on. If necessary, to satisfy the 
installation's changing needs. 


The axamoles presented In this publication are for illustrative 
purposes only* they not intended for execution. 



For the sake or clarify in examples, user typeins <commands and 
directives) are distinguished from system tyoeouts (responses) by 
arrows, as shown* 


*> Command line 

SYSTEM RESPONSE 

The following conventions are used to indicate the relative levels 
of topic headings used in this manual* 


Level 1 (highest) 
Level 2 
Level 3 
Level 4 


ALL CAPITALS, UNDERLINED 
Initial Capitals, Underlined 
ALL CAPITALS, NOT UNDERLINED 
Initial Caoltals, Not Underlined 


Symbols used In this manual are described below* 

. brackets II indicate an ootlonal directive entry. 

. Braces { } enclose Information from which a choice must be 
nade * 

. The character A indicates a space. 
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SECTION I 


SYSTEM BUILDING OVERVIEW 


System building consists of several discrete ©Derations, each 
described in different sections of this manual* The purpose of this 
section is to place these ooerations into perspective, and to enable 
you to obtain a general view of the system building process. 

CII HONEYWELL BULL delivers a disk volume containing the software 
you ordered oius an ooerating MOD 400 Executive. System building 
consists of specifying your system variables, identifying your 
peripneral devices and (optional) communications environment and 
tailoring main memory to suit system and user needs. A “system 
build.'* starting with the initially suoolted system, consists of the 
ooerations described below. 


PRELIMINARY CONSIDERATIONS 


Before starting to build your system, you must take stock of the 
hardware in your configuration. You must be familiar with the 
characteristics of each peripheral and (optional) communications 
device. You must also be aware of what software oackages you wish to 
build into your system, consulting the appropriate software manuals 
as necessary. These preliminary considerations are discussed in more 
detail in Section II. 


INITIAL SYSTEM STARTUP 


System b»jildlng Is a progressive process and is typically performed 
ir. tnree discrete stages, each of which is initiated by an 
aDorooriate tyoe of system startup. To build your new MOD 400 
system, you must first start uo the initially supplied system on 
your hardware configuration. The system is designed to start ud 
without difficulties on most hardware configurations. 

The three stages of system startup, and the ourpose of each stage, 
are described in Section III. Each stage of system startup involves 
(t) bootstraoping the system from disk into,main memory, (2) 
execution of the Configuration Load Manager (CLM) which reads a file 
of CLM directives and causes the system to be configured 


> 1-01 




accordingly, and <3> creation of a system task group. As described 
in Section III, additional actions are possible at system startup, 
depending on whether a special file (named START...UP.EC) exists in 
the initial working directory of the system task group. 


SYSTEM BJIL3ING 


System building consists of creating a file containing a series of 
system building directives which comoletely specify the 
characteristics of the system. These characteristics include the 
hardware options and physical memory oresent in the central 
processor, the complement of peripheral and communications devices 
oresent in your configuration, and the manner In which memory is to 
be allocated among system and application tasks. (The system 
building directives are described In detail in Sections V and VI). 

You create this directive file on disk, using either an interactive 
building program or the standard text editor. Once created, the file 
contains configuration directives, which when executed, will 
configure a system that corresponds to the actual installation 
hardware. 


HOW TO USE THIS MANUAL 


Sections I, II and III should be read carefully before you begin 
system building procedures. Sections I and II provide a general 
description of system building and outline the information a 
first-time user needs to know before building a specialized system. 
Section III describes the three stages of system startup that must 
oe followed to create an operating environment. 

An interactive CLM directive generation program, called M4_SYSDEF, 

Is provided for your convenience in creating the CLM directive file, 
and is fully described In Section IV. Using M4_SYSDEF according to 
directions will result in a syntactically correct file of CLM 
d irectives. 

ion-communications CLM directives and communications CLM directives, 
used to specify the system configuration, are described in detail in 
Section V and VI, respectively. Refer to these sections when 
creating or modifying your specialized CLM directive file. If your 
system supports communications devices, you should be familiar with 
the Communications Processing manual. 

Section VII describes the contents of the system release media. 
Typically, an installation will receive ail of its system software 
(including any separately orlced “extensions" that have been 
ordered) on one type of release medium; that is, on one or two 
cartridge disks, on one mass storage unit (also called a "storage 
module"), on one cartridge module disk, or on multiple diskettes. 
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Section wlli comprises a number of miscellaneous technical notes, 
.nost of which pertain only to certain installation sites. It Is 
important that each DrosDective system builder familiarize himself 
with the contents of Section VIII and ascertain which of its topics 
apply to his Installation, before he attempts to use the system, 

Most of the aopendixes In this manual also describe subjects of 
interest only to certain installation sites. Among these subjects 
are configuration information regarding the Data Entry Facllity-I 
(Di£r-I), the Remote Batch Facility ( wl»F) , and file transmission. 

Appendixes H, J, and K present configuration information for the IBM 
dorKstatlon Facilities and the D rogrammable facillty/3271. Appendix 
L describes Listener and Login capabilities. 

An M4_SY5DEF checklist is supplied for your convenience in Appendix 
M. Use this list as a guide when defining your system^s resources 
prior to invoking the M4_SYSDEF program. 

Appendix N describes how to configure the error loaging capability 
so your installation can monitor memory and device performance. 

Appendix P describes configuration procedures for the Display 
For netting and Control software. This software provides the forms 
processing capability for your Installation. 

In general, this manual does not include conceptual information* 
ir.steaJ, where necessary, see the System Concepts manual and/or a 
manual specific to the desired subject area. Commands mentioned in 
this manual are described in the Commands manual. Those operator 
commands that are not available to the general user community, for 
exanoie the CSD (change system directory) ooerator command, are 
described in the Operator's Guide . System macro calls are described 
in the System Service Macro Calls manual. 
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SECTION II 

PRELIMINARY CONSIDERATIONS 


iefore you actually begin to build your system* you should first 
compile the information you-'ll need to configure the system to your 
soecifications. The categories of information required are broken 
into hardware, software* and communications considerations and are 
discussed further below. Figure 2-1 is a flowchart of the 
recommended orocedure for gathering Information. 
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HARDWARE CHARACTERISTICS 


You must have available the hardware characteristics of the devices 
in your configuration. You can obtain this information by consulting 
the appropriate hardware reference manuals as necessary. 

Specifically, for the central processor, you must know* 

. The model number 

. Whether the central processor is a commercial model 

. Whether the central processor includes the Scientific 
Instruction Processor 

. The size of main memory 

. The number of multiole/dual-line communications processors 
(MLCPs/OLCPs) 

For peripheral devices, you must know* 

. The maximum number of devices that you want to configure 
(regardless of how many are on the bus) 

. How many of each type of oeripheral device you have in your 
configuration, identified by marketing identifier (see Aooendix 
C) 

. ror terminals, you must know the transmission modes, line 
soeeds, desired I/O characteristics, and modem types 

. Por disk devices, you must know whether each cartridge disk or 
cartridge module disk has a fixed and removable platter! you 
must also know the storage capacity of each device 

. Por tape drives, you must know the recording density and number 
of tracks. 


SOFTWARE CHARACTERISTICS 


Once you have compiled a list of hardware characteristics, you 
should proceed to gather information on the software characteristics, 
of your configuration. You must determine what software subsystems 
your installation will use. Equipment requirements and 
characteristics of individual software packages are available in tire 
appropriate software reference manuals. 

Specifically, you must know* 

. The text strings you wish to use as the system and installation 
identification of your system 
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. The anticipated maximum number of concurrent users 

. The largest logical file number and logical resource number 
available to users 

. The anticipated number of 512-word system overlay areas 

* Whether or not the system will include a batch memory pool (and 
Its size) 

. Whether the system will include the commercial or scientific 
instruction simulators 

» Whether or not the system will Incorporate record locking or 
Display Formatting and Control software 

. A coherent assignment scheme for symbolic oerlpheral device 
names* channel numbers * communications priority levels, and 
logical resource numbers (see tna System Concepts manual) 

« The number of communications line protocols (the recommended 
maximum Is two per MLCP/DLCP). 


COMMUNICATIONS CHARACTERISTICS 


If you Intend to Include communications devices In your 
configuration, you must read the Communications Processing manual 
first* and be thoroughly familiar with the hardware and software 
characteristics of your communications devices. 

Specifically* you must know* 

* dhtch protocols you need 

. For polled VIP devices (VIP7700 or VIP7804)* a ooll address 
scheme, device type* which stations are control/tributary 
stations, and characteristics of any receive-only printers 

. For H3270 Host Links, a poll address scheme, a select address 
scheme, and a communications priority level for each line 

. A priority level starting scheme 

. The number of channel control programs oer MLCP/DLCP (the 
recommended maximum is two) 

. For asynchronous terminals, the communications priority level 
and device type for each 

. For BSC lines, the communications oriority level and the number 
of primary and/or secondary lines 




, ror ACU cnanneis, the lrn of the station associated with each 
ACU and the list of telephone numbers associated with each data 
communications channel 

. For stations driven by a user-written line protocol handler, 
whether the line Is full— or half-duolex, and the lph-speclfic 
word for each station 

. For teleprinter compatible devices, the communications priority 
level and modem type for each device 

. tfhich communications stations will be accessible through the 
file system 

. The polling scheme on a line serviced by the synchronous 
terminal driver line protocol handler 

. For polled or nonpolled VI? terminals, the lrn, level, and 
channel 

. For IBM workstations on a line serviced by the HAS? line 
orotocol handler, the lrn, level, and channe1 

. For stations on a line serviced by the Remote Computer 

Interface line Drotocoi handler, the lrn, level, and channel. 

This is only meant to be a representative sampling of some of the 
software and hardware characteristics of which you must be aware. 

For a full description of each communications protocol, see Section 
VI. 


2-05 


D 



SECTION III 


SYSTEM STARTUP 


System startup consists of the following steos* 

1. The system is bootstrapped into main memory as the result of a 
procedure performed at the central processor's control panel. 

2. The Configuration Load Manager (CLM), a system component, 
reads a file of CLM directives* which causes the system to be 
configured according to the contents of the directives. 

3. A system task group ($S) is created after system configuration 
is completed. If the initial working directory for the system 
task group contains a file named START_UP.EC, the operator 
commands in that file are executed to further establish the 
environment that is desired at the end of system startup. (For 
example, the START_UF.EC file may contain operator commands 
that spawn additional task groups.) 

Thus, system startup establishes an operating environment and brings 
the system to a ''ready" state, at which point system operations may 
begin. 

There are three stages of system startup. 

I. Stage 1 Initial System Startup, which is performed at system 
installation.(i) This tyoe of startup is used to establish a 
limited environment that will allow you to use the Interactive 
CLM directive generation program M4_SYSDEF or the Editor to 
create your own file of CLM directives. Curing a stage 1 
system startup, the Configuration Load Manager reads one of 
two supplied files of CLM directives that define a limited 
environment. The file of CLM directives read by the 
ConfIguration Load Manager depends on which of the following 
situations exist at system startup* 

a. Bootstrap volume is a cartridge disk, cartridge module 

disk, diskette, or mass storage unit* one or more terminals 
are connected to an MDC. 


( I ) 

A stage 1 system startup can also be used at a later time, in the 
event that an error in a user-created file of CLM directives 
orevents a successful stage 2 or stage 3 system startup. See 
"Sootstrao Motions" later in this section. 
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b. bootstrap volume is a cartridge disk* cartridge module 
disk, diskette, or mass storage unit! no terminal Is 
connected to an MDC, but one or more terminals are 
connected to an MLCP/DLCP. 

In a stage t system startup', the initial working directory for 
the system task group is SID, This working directory contains 
a STARTJJP.EC file that causes a second task group ($S) to be 
spawned. (I) 

2. Stage 2 Intermediate System Startup. This stage of system 
startup is used after you have created your own file of CLM 
directives, l«e«, a file named CLM_USER (under SID), which 
describes your own Installed hardware configuration and other 
details of the environment you wish to use for application 
development, (You will have created CLM_JSER by using 
M4_SYSDEF or the Editor In the limited environment established 
as the result of a stage I system startup,) 

In a stage 2 system startup, your tailored CLM_USER file must 
exist under directory SID on the bootstrao volume. The 
Configuration Load Manager will read this file Instead of the 
one selected during a stage t system startup. 

In a stage 2 system startuo, the Initial working directory for 
the system task group is the root directory of the bootstrap 
disk. This working directory contains a START_UP.EC file that 
causes a second task grouo ($H) to be spawned. 

Following a stage 2 system startuo, aoolicatlon development 
can oroceed In an environment you have defined to match your 
own resources and needs, rthen you have reached a point where 
you wish to define a fully soeciallzed system refined to 
oreclsely match your reoulrements for a standard ooerating 
environment, you can use the M4_SYSDEF program In Rebuild mode 
or the Editor to modify the contents of CLM_USSR so that they 
describe your final system. In addition, you can modify (or 
delete) the START_UP.EC file of operator commands immediately 
subordinate to the root directory of the bootstrap volume. 

Note that "refining" takes place over a period of time, as you 
gain experience with the system. 

3. Stage 3 Fully Soeciallzed System Startup. This stage of system 
startup'is used after you have made finaT adjustments to the 
CLM directives in the CLM_,USER file and any necessary 
modifications to the START_UP.5C file. This stage of system 
startup is used to achieve your final configuration, one that 
reflects your total hardware environment, optimized use of 
central processor main memory, and all other characteristics 
of your standard system. 


(I) 

>SID>START_UP.EC is reserved for use during a stage 1 system 
startup* 
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)ncc a satisfactory CLM.USER file and START_UP.EC file (if 
any) have been established, this tyoe of system startup can be 
performed routinely, even by noncomputer personnel. 

igure 3-1 summarizes the three stages of system startup. /■' 


STAGE 1 INITIAL SYSTEM STARTUP 

ONE Or TWO CII HONEYNELL BULL 
SULLIED FILES OF CLM DIRECTIVES 
IS JSEDTO DEFINE A LIMITED 
ENVIRONMENT WHICH M4_SYSDEF 
OR THE EDITOR CAN BE SUN TO 
CREATE AN INSTALLATION-SPECIFIC 
FILE OR CLM DIRECTIVES. 

(>SID>START_UP.EC FILE IS EXE- 
CJTED FOLLOWING CONFIGURATION.) 

STAGE 2 INTERMEDIATE SYSTEM 
STARTUP 

USER-CREATED FILE OF CLM 
DIRECTIVES. CLM USER. IS USED 
TO DEFINE AN ENVIRONMENT IN 
WHICH APPLICATION DEVELOPMENT 
CAN BE PERFORMED. (~RQOT 
JI RECTORY>START UP.HC FILE IS 
EXECUTED FOLLOWING 
CONFIGURATION.) 

STAGE 3 FULLY SPECIALIZED 
SYSTEM STARTUP 

FULLY SPECIALIZED FILE Or CLM 
DIRECTIVES (ADJUSTED CLM USER) 

IS JSSb TO DEFINE THE STANDARD 
ENVIRONMENT FOR FULL SYSTEM 
OPERATIONS. (IF PRESENT. 

~R JOT DIRSCT03Y»START_UP.EC 
FILE IS EXECUTED FOLLOWING 
CONFIGURATION.> 


WHEN PERFORMED 

ONCE AT SYSTEM INSTALLATION. 
THEREAFTER. IF NECESSARY, TO 
PERMIT CORRECTION OF ERRORS IN 
USER-CREATED FILE OF CLM 
DIRECTIVES. 


WHEN PERFORMED 


ONCE AT SYSTEM INSTALLATION, 
AFTER CREATION OF CLM.USER 
FOLLOWING A STAGE 1 SYSTEM 
STARTUP. THEREAFTER, AS 
NECESSARY. 


WHEN STANDARD SYSTEM OPERA¬ 
TIONS ARE FEASIBLE, AFTER 
NECESSARY APPLICATIONS HAVE 
BEEN CREATED FOLLOWING A 
STAGE 2 SYSTEM STARTUP. A 
STAGE 3 SYSTEM STARUP CAN 3E 
PERFORMED ROUTINELY AFTER 
SATISFACTORY CLM USER HAS BEEN 
ESTABLISHED. 


Figure 3-1. Stages of System Startup 



STAdE 1 SYSTEM STARTUP (INITIAL SYSTEM STARTUP) 


A stage I system startup causes the system to be bootstrapped, the 
Configuration Load Manager to configure the system using an existing 
the of CLM directives, and the operator commands in the 
>SID>START_UP.EC file to be executed. The result is a limited system 
environment that allows you to use the interactive CLM directive 
generation program M4_SfSDEr or the Editor to create your own file 
of CLM directives. 

The environment achieved by a stage I system startup is as follows* 

. A removable cartridge disk, cartridge module disk, a mass 

storage unit, or a diskette (depending on the device from which 
the system was bootstrapped). 

. Either an MDC-connected operator termial or an MLCP.DLCP 

connected operator terminal* (The former is used, if present). 

. ;)ne online memory oooi and one online task group ($H), in 
addition to the system memory pool and system task group <$S). 

A stage I system startuo consists of the following steos* 


I. Set the central orocessor control panel POWER switch to ON and 
turn on the power for all devices. 


2. Mount the volume containing the CII HONEYWELL BULL-sunolied 
system software on the bootstrap device (cartridge disk, 
cartridge module disk, mass storage unit, or diskette). 


3. Perform the following bootstrap procedure at the central 
processor control pannel* 


a. Press Stop. 

b. Pres3 CLeaff* 

c. Press Load. 


J. Press Execute. 

e. Wait for the TRAFFIC light 
channel is not 04C0 and/or 
described in Table 3—2 are 
Startup Actions," later in 


to turn off. (If the bootstrap 
If any of the boots trap.options 
to be used, see "Ooerator's 
this section). 


f. Press Ready. 

g. Press Execute. 

The system is bootstraoped into main memory. Depending on 
the terminal configuration, one of the two suoolled flies 
of CLM directives under directory SID Is read by the 
Configuration Load Manager and the system is configured 
accordingly. 




(I; CL«i_"OC is used if the bootstrao volume is a cartridge 
disk, cartridge module disk, mass storage unit, or 
diskette* one or more terminals are connected to an 
MLCP/DLCP. 

(2) CLM_MCP is used if the bootstrap volume is a cartridge 
disk, cartridge module disk, mass storage unit, or 
diskette* one or more terminals are connected to an 
MLCP/DLCP, 

If your configuration includes both MDC- and MLCP/DLCP 
connected terminals, the system uses CLM_MDC. 

A system task group ($S) is spawned. The ooerator commands 
in >SID>START_UP*EC are executed, and a user task group 
(SH) is soawned. 

If your configuration includes a terminal connected to an 
MDC, system startup is now comolete. otherwise, your 
configuration must include a terminal connected to an 
MLCP/DLCP and you must perform steps h, i, and J (full 
control panel required). 

h. Wait for the TRAFFIC light to turn off. (If the terminals 
line speed should be other than DMO bits per second- the 
default value -enter the appropriate line sDeed in the 
Rl-register. See the paragraoh below and Table 3-1). 

i. Press Ready. 

j. Press Execute. 

The operator terminal is selected as follows* 

1. If there are one or more terminals connected to an MDC, the 
one with the lowest channel number is selected. 

2. If there are no terminals connected to an MDC, there must be 
one or more terminals connected to an MLCP/DLCP. In this case, 
the MLCP/DLCP-connected ter mina1 wlth the highest channel 
number is the operator terminal. 

Since a communications terminal can run at different line 
speeds, you must determine the connect line soeed of the 
terminal with the highest channel number and then, in the 
orocedure described above, when the TRAFFIC light turns off in 
step 3h, you ent*r the correct line sDeed in the Rl-register. 
The default value Is OHO bits oer second. 

Comoletion of system startup Is signalled by the message shown in 
Figure 3-2. If your terminal is connected to an MDC, don't press any 
terminal keys until after the system startup message anoears. If you 
1o, you can recover by pressing the BREAK key. 
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{$S)GC()S6 MOD40Q - arrr -mm/dd/hhnn 
($H)$H Group ready! 

MolH* See the accompanying text for an explanation of 
the variables in the first line. 


Figure 3-2. System Startup Typeout at Operator Terminal 


The system startup message, shown in Figure 3-2, Is Interpreted as 
follows * 

. ($S)GC()S6 M00400 - arrr - mm/dd/hhnn 

Indicates the completion of system startup. A is S for a SAF system, 
L for a LAF system, rrr indicates the release number of the system 
Executive, mm/dd/hhnn indicates the date/time when the Executive 
was linked (nonth, day, hours, minutes). 

. ($S)$H Group ready! 

Indicates that a user taks group, which has the command processor as 
its lead task, is ready for the entry of commands. This task group 
has been spawned by a command in >SID»START_UP.EC. Pie tyoeout is 
the result of a command in the supplied >HIS» START. UP.EC file. 


) 


Table 3-1. TTY Terminal Line Speeds 


Type 2100, 2110, or 2118 


TyD e 2108 

Jommunications-Pac 

Communic at ions-Pac 


Speed 

Speed 

(Entered 

in Rl-Register) 

(Entered in Rl-Register) 


0050 

0050 


0075 

0075 


0110 

OJ 10 


0134 

0134 


0150 

0150 


0300 

0200 


0600 

0300 


0900 

0600 


1200 

1 050 


1800 

1200 


2400 

1 800 


3600 

2000 


4800 

2400 


7200 

4300 


9600 

9600 


0 


MOTE* A soeed of 0134 represents 


134.5 bits/second. 
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STAJE 2 SYSTEM STARTUP (INTERMEDIATE SYSTEM STARTUP) 


A stage 2 system startup can be Derformed only after you have 
created your own file of CLM directives, named CLM_USER under 
directory SID on the bootstrap volume. The contents of CLMJJSER 
should described the environment you wish to use for application 
development. 


Creating CLM.USER 

The recommended approach for creation of CLM_USER is shown below. 

t. Following a stage 1 system startuD, invoke M4_SYSDEF to run 
under task grouo $H. Although you can create the CLM_USER fils 
directly by using the Editor, CII HONEYWELL BULL recommends 
that you use M4_SYSDEr, the interactive system building 
program, even if you have build the system before. See Section 
IV for a complete description of how to use M4_SYSDEr. 

2. After creating a CLM_USER file using M4_SYSDEF and placing It 
immediately subordinate to directory SID on your bootstrap 
volume, continue with the steps necessary for a stage 2 system 
startup. 

If you wish to create your own CLM.USER file wlthout using 
M4„SYSDEr, or if you wish to modify the existing CLM file to reflect 
changes in your installation's configuration, follow steos 1 through 
7 below to use the Editor. 


USINJ THE EDITOR 


I. Following a stage 1 system startup, invoke the Editor to run 
uner task group sH* 

You may be reauired to change the default task group of the 
opera tor's terminal from the $S (System) ta sk group to the SH 
task group. Enter the following lines at the operator's 
terminal immediately following system startup* 

C *$H* (transfers default task grouo of the operator's 
terminal from $S to SH task group). 

RDN (The ready on (RDM) command causes a prompt 

message to aopear at your terminal. This command 
Is for convenience only and Is not reauired). 

If you have entered RON. the system will respond with the 
prompt message* 

($H)ROY i 
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Note that no prompt message appears unless you specified RDN. 

You are not ready to Invoke the Editor, as described In the 
Commands manual and the Program Preparation manual. Sample 
Editor work sessions are provided In the Programmer's Guide . 

2. If you are modifying an existing CLM file, use the Editor's 
read directive to read the file's contents into the Editor's 
"current buffer". If you are creating a CLM file, go to step 
5 . 

J. Use the Editor's print directive to orlnt out the entire 
contents of the current buffer. 

4. Inspect the printout and identify the differences between the 
contents of the current buffer and your desired file CLM 
directives. 

5. Use the Editor's insert, change, append, and Jelete directives 
to modify the contents of the current buffer so as to define 
the CLM directives that describe your application development 
configuration. 

4 * Use the Editor's print directive to print out the entire 
contents of the current buffer. Ensure that the contents 
accurately reflect your desired CLM directives. (If any 
corrections are necessary, repeat steos 5 and rf). 

7, Use the Editor's write directive to write the entire contents 
of the current buffer to >SID>CLM_U$ER. (You may give your CLM 
file any name you wish, although it is recommended that you 
call it CLM_USER. Note that the Configuration Load Manager 
must be able to locate a file named CLM^USER at system 
startup. 


Stage 2 Startup 

One you have defined the desired contents if >SID»CLM_USER, you can 
perform a stage 2 system startup by taking the following steps* 

1. Ensure that the central processor control panel's POWER switch 
is ON and turn on power to all eaulpment. 

2. Ensure that the volume containing the Cl I HONEYWELL 
BULL-suoolied system software is mounted on the bootstrao 
device. 

3. Perform the following bootstrao procedure at the central 
processor control oanel* 

a. Press Stop. 

b. Press CLeaR. 

Wait for CHECK light to go out. 
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c. Press Load. 

d. Press Execute. 


e. Wait for the TRAFFIC light 
channel is not 0400 and/or 
describes in Table 3-2 are 
Startup Actions." later in 

f. Press j£eady. 


to turn off. (If the bootstrap 
if any of the bootstrap options 
to be used, see “Operator's 
this section). 


g. Press Execute. 


The system is bootstraoped into main 
file in directory SID is read by the 
Manager and the system is configured 


memory. The CLM_USER 
Configuration Load 
accordingly. 


A system task grouo ($3) is spawned. The operator commands 
in the CII HONEYWELL BJLL-supplied *root.directory 
>START_UP.EC file are executed, causing a user task group 
($H) to be spawned. 


System startup is complete. The system startup message is Issued at 
the operator terminal, which, in the case of a stage 2 system 
startuo, is the terminal assoc la ted with logicai resource number 
(lrn> 0 in a CLM directive. (If the operator terminal is connected 
to an MLCP/JLCP, the terminal's line speed and other communications 
characteristics are defined in a CLM directive). 

If a CLM directive in CLM_ISER contains an error caused by incorrect 
syntax or if the CLM directive is an invalid duplicate, an error 
message will aooear at the operator terminal (if possible). S 3 e 
"Configuration Load Manager Error Reporting" at the end of this 
section. If an uncorrectable error prevents sucessful completion of 
a stage 2 system startup. It Is possible, by means of the 
appropriate bootstrap option (see Table 3-2), to bypass the CLM_USFR 
file and perform a sta^e 1 system startup using one of the two 
supplied files of CLM directives. This technique allows- you to 
re-establish a limited system configuration in which you can use the 
Editor or M4_SYSDEF to correct CLM_USER before reatterrpting a stage 
2 system startuo. 

Note also that the supplied START_UP.EC file directly subordinate to 
the bootstrap volume's root directory is normally not modified prior 
to a sta;e 2 system startuo. 

once a satisfactory stage 2 system startup has been achieved, you 
can use the resulting system for aoolication development or as a 
means of gaining experience in the use of the systen software. 
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STAGE 3 SYSTEM STARTUP (FULLY-SPECIALIZED SYSTEM STARTUP) 


K stage 3 system startup is very similar to a stage 2 system 
startup. The principal difference is that application development 
performed following a stage 2 system startup provides you with 
information you may wish to use in refining the CLM directives in 
your CLM_USER file. For example,. you may wish to change certain 
MEMP;k)L directives and/or cause certain system overlays to be made 
permanently resident. Moreover* you may wish to describe additional 
peripheral devices that were not previously identified in CLM_USER 
because they were not used during aoolication development. 

Thus, orior to performing a stage 3 system startup, you will 
probably have used the Editor or M4_SYSQEF to uodate the contents of 
CLMJJ5ER. Additionally, you must decide whether to retain, modify, 
or delete the START_UP.EC file Immediately subordinate to the 
bootstrap volume's root directory (i.e.. the START_UP.EC file used 
in a stage 2 system startuo). If you wish to retain this 
3TART_UP.EC file in its original condition (but not use it during a 
stage 3 system startup), you may use the RENAME command. 

The steps oerformed in a stage 3 system startup are identical to 
those used for a stage 2 system startup except that the 
'"‘rooted tree to ty>STARTJJP. EC file may have been modified or deleted. 
If this file exists at the time of a stage 3 system startup, all 
operator commands therein will be executed. 


SUMMARY OF STARTUP PROCEDURE 


The following paragraphs and Figure 3-3 summarize the startuo 
procedure. 

Every time the system is bootstrapped, a software component 
ascertains whether an initially-supplied or a user-created file of 
CLM directives is to be read by the Configuration Load Manager. If 
an initially-supolied file Is used, a software algorithm also 
ascertains whether the operator terminal is to be an MDC—connected 
terminal or an MLCP/DLCP-conneeted terminal. If a user-created CLM 
file is used, a CLM directive dictates which device is to be the 
operator terminal. 

during a system startup in which an initiaLly-suoolled CLM file is 
used (i.e., a stage I system startup), operator commands in the 
3TART„UP.EC file in directory >SID will be executed. Durinq a stage 
2 system startup (user-created file of CLM directives used), 
operator commands in the suoplied START_UP.EC file under the 
bootstrao volume's root directory will b executed. During a stage 3 
system startup (refined user-created file of CLM directives used), 
operator commands in the START_UP,EC file under the bootstrap 
volume's root directory will be executed if such a file is present 
either in its original form or as modified by the user. 
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BOOTSTRAP 



Figure 3-3. Flowchart of System Startuo Process 
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Figure 3-3 (Cont). 


Flowchart of System Startup Process 
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operator's Startup Actions 


The operator's actions at system startuo are as follows* 

1. Set the central processor control panel POWER switch to ON. 
Turn on power for all devices. 

2. Ensure that the volume containing the CII HONEYWELL 
BULL-suppiied system software Is mounted on the bootstrap 
device. 

3. Perform the following bootstrap procedure at the central 
processor control panel* 

a. Press .Stop, 

b. Press CLeaR. 

Halt for CHECK light to go out. 

c. Press Load. 

d. Press Execute. 

e. Walt for the TRAFFIC light to turn off. 

If the bootstrap channel Is not 0400 and/or if any of the 
bootstrap options shown In Table 3-2 are to be used, 
perform the following steps* 

( l) Press Stop. 

12) Press Select. 

(3) Press Dl on the hexadecimal keyoad, so that Dl appears 
In the LOCATION indicators. 

(4) Press .Change. 

(5) Press appropriate keys on the hexadecimal keypad so 
that the CONTENTS Indicators show the desired hootstrao 
channel and options. 

(6) Press Run. 

f. Press jExecute. 

The system is bootstrapped Into main memory. (If the 
bootstrap halt option was soscified In step e(5) above, the 
central processor halts, with Dl equal to what was entered 
In step e(5), as soon as the system has been bootstrapped* 
after performing any desired actions, again press Execute 
to continue. If .Stop, Run, or .Write was Invoked in these 
actions, press Run and ^Execute to continue). 
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(In <i stage I system startup with an MLCP/DLC°-connected 
operator terminal, wait for the TRAFFIC light to turn off; 
then ensure that tne R1-register contains the proper line 
speed for the operator terminal and press Execute to 
continue). 


Table 3-2. Bootstrap Options 


Bits In Low-Order 
Digit of 4-Digit 
Hexadecimal Boot¬ 
strap channel 

a 

Number Meant ng if 311 Set ON 


15 After the initial bootstrap record is read from 

<low-order bit) the removable clatter of the cartridge disk whose 

channel number is contained in bits 0 through 9, 
the remaining records are read fron the fixed 
platter. 


14 Ignore CLM_USER file if it exists under directory 

SID. Instead, use the suoolled file of CLM 
directives appropriate to the bootstrap device and 
terminal configuration (l.e., CLM_MDC or CLM_MCP). 


13 The central processor halts after the system is 

bootstrapped and before execution of the Executive 
begins, and before execution of CLM. (To continue 
after the halt, press Execute). 


These bits may be set ON in any desired combination. Thus, the 
value of the low-order digit of the 4-digit hexadecimal bootstrap 
channel number may range from 0 (no oDtlons) to 7 (all options). 


System Startup Actions 


System startup actions continues without further operator 
intervention. 

I. The Conf igura tio.i Load Manager reads CLM directives from the 
approprlate file* 

a. If CLM_(JSER does not exist in directory SID on the 
bootstrap volume, one of the two CII HONEYWELL 
BULL-supplied files Is used. 
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(1) CUOIDC is used If the bootstrap volume is a cartridge 
disk, cartridge module disk, mass storage unit, or 
diskette, and one or more terminals are connected to an 
MDC, <The terminal with the lowest channel number will 
be used as the operator terminal). 

(2) CLM.MCP Is used if the bootstrap volume is a cartridge 
disk, cartridge module disk, mass storage unit, or 
diskette, and one or more terminals are connected to an 
MLCP/DLCP.'(The terminal with the highest channel 
number will be used as the ooeratoF terminal). 

b. If CLM_US£R does exist under directory SID on the bootstran 
volume, It wiI X be used unless bit 14 of the bootstrap 
channel is set ON, in which case one of the system actions 
described under a (above) is followed. 

2. The system task grouo is created as If the following command 
has been executed, without user intervention* 


SG 


(spawn group command) 


$S (task.group.id) 

OPERATOR.SYSTEM.OPR (us er_id) 


highest priority level (base_priorlty_level) 

+ 2 in CLM directive 

ICONSOLE (in_path, also 

outjaath by default) 


-ECL 


(lead task) 

-LRN 

highest Irn In 

CLM directive 

(highest Irn) 

-U=N 

15 

(highest Ifn) 

-POOL 

system oool 

(memory poll) 

-WD * 

root.directory If 

(Initial working 


CLM directives were directory) 
read from CLMJJSERs 

SID if CLM direc¬ 
tives were read from 
CLMJ4DC or CLM.MCP. 


3. A system-suoplled START.UP.EC file is in directory SIDs its 
operator commands are executed when a stage J system startup 
is performed (i.e., when CLM directives are read from CLM.MDC 
or CLM_MCP). Another system-supplied START.UP.EC file is 
Immediately subordinate to the root directory of the bootstrap 
volumes its operator commands are executed when a stage 2 
system startup is performed. 
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Both 37ART_UP.EC files cause a user task group ($H) to be 
soawned. The working directory for $H is HIS, which in turn 
contains a system-supplied START.UP.EC file that oerforms a 
CWD (change working directory) to A root_directory. 

Regardless of which file of CLM directives is used, the 
working directory for the system task group is always 
*root_directory at the end of system startup. 

4. The system startup typeout (see Figure 3-2) Is Issued at the 
operator terminal. 

* 

When system startup is complete, as signified by the system startup 
typeout, operator commands may be entered to the system. 


CONFIGURATION LOAD MANAGER ERROR REPORTING 


If, when the Configuration Load Manager is reading CLM directives 
from CLM.USER, it detects that a directive contains a syntax error 
or is an Invalid duplicate of another CLM directive, it issues (if 
possible) a 2-line error message at the operator terminal. The 
nessa-ge has the format shown below* 

($3) ( I3yyzz) hh 

secondary message Indicating the CLM directive causing the error 

yy - code identifying the system comoonent that has detected the 
error 

zz - error code (see the System Messages manual) 

hh - priority level of tne task group executing the Configuration 
Load Manager 

fou can (if appropriate) byoass the error by typing * (asterisk) at 
the operator terminal and pressing RETURN. Otherwise, you must enter 
a correct CLM directive through the operator terminal and press 
RETURN, The remainder of the CLM directives in CLM.USER will then he 
processed. 

An error message cannot be issued if an ooerator terminai is not 
available because (I) the CLM DEVICE directive for an MDC-connected 
operator terminal has been omitted or (2) the operator terminal is 
connected to an MLCP/DLCP in which case it is not operational until 
system startup is complete or (3) the error occurred he fore the 
DEVICE directive defining the console was read. (For this reason, it 
is important to place the directive early in the CLM.USER file). In 
these cases, errors are reported through the hardware registers 
shown below, which are accessible through the central orocessor 
control panel. Refer to Section V in the Minicomputer Systems 
Handbook (CC7I) for procedures to follow in reading out registers 
and memory locations. 


3-17 



Rl-register contains yyzz (as described above) 

R2-register Zero or a 1-word secondary message in hexadecimal 
notation,. 


Reregister zero or the address of the first word of a secondary 
message in ASCII notation (the left byte of this word 
is a control byte) 

83-register zero or the address of the first word of the CLM 

directive causing the error provided the error occurred 
before the QUIT directive* 


As described earlier in this section, in the event of an 
uncorrectable error in CLM^USER, it is possible to return to a stage 
I system startup (using the appropriate bootstrap ootion) and 
re-create a limited system environment in which M4_SYSDEF or the 
Editor can be used to correct the error in CLM_JSER. 


See Aopendix A for information about other halts that are possible 
during system startup* 
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SECTION IV 


* 


USING M4_SYSDEr 


M4_SY5DEr, an Interactive program that generates a CLM directive 
file* Is provided for your convenience In creating the CLM_USER 
file, and is fully described In this section. 

The system bJildiivg CLM directives themselves are described In 
detail in Sections V and VI. Note that some of the directives - and 
thus some of the MOD 400 software - are not suoported by M4_SYSDEF. 
See "44_SYSDEF Operating Considerations", later in this section. 


INTERACTIVE SYSTEM BUILDING PROGRAM 


The interactive CLM directive generation program M4_SYSDEF is 
designed to help you create the CLM directive file CLM_USER. It 
converts information you give it, In response to its prompts, into 
the CLM directive file. M4_SYSDEF is designed to produce a 
directive file adequate for the average user and which will always 
result In an operate MOD 400 Executive. 

Although you can create the CLM directive file directly, using the 
Editor, CII HONEYWELL 3ULL recommends that you use M4_SYSDEF, even 
if you have built the system before, because M4_SYS0Er* 

. Is Interactive* it prevents you from forgetting any necessary 
Information. 

. Tests each of your responses for validity. 

. Includes online explanatations of each of its pompt messages. 

. Ensures that a comolete, oroperly ordered directive file Is 
oroduced. 

. Allows you to interactively add* delete, or modify Information 
you soeclfy at any point in the program. 

. Performs all calculations of memory required by your Executive; 
the resulting memory sizes should never be less than your 
requirements. 

. dullds In all hardware devices suooorted by CII HONEYWELL 3JTL. 
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. Generates* at your option, symbolic perioheral device names for 
all devices in your configuration. 

. Generates, at your option, channel number assignments for all 
noncommunications devices in your configuration* 

, Produces, at your option, a listing of the directive file at 
your terminal, before generating the final output file, 

. Automatically generates a file containing configuration 

information that enables you to verify the success of certain 
aspects of the system building process. 

, At your option, automatically configures all asynchronous 

communications devices fTTY and ATD) as being reconnectable in 
the event of a power failure or line drop. 

Appendix M contains a checklist for your convenience in gathering 
the information M4_SYS0EF requires. Appendix C lists the hardware 
available under MOD 400, 


Required Resources 


M4„SY3JEF requires I OK words of memory to operate. It can run in the 
MOD 400 minimum system. 


M4_SYSDEF operating Considerations 


You snould consider the following whan executing M4_SYSDEF* 

1. If you allow M4_SYSDEF to dynamically assign channel numbers 
to your devices, you will only need to supply channel numbers 
for MLCP/DLCP - connected (communications) devices. If you do 
not choose this option, you will be asked to explicitly 
specify channel numbers for all devices in your configuration. 
(See Section V for information on dynamically assigned channel 
assignments for non-cammunlcatlons devices). 

2. If you choose to let M4__SYSDEF supply the channel numbers for 
all non-communications devices* 

. M4_SYSDEF will assign the channel to be used for the 
operator terminal. If the operator terminal is to be an 
MDC-connected terminal, the program uses the device with the 
numerically lowest channe1 number as the operator terminal. 
If the operator terminal is to be an MLCP/DLCP-conneeted 
terminal, the program uses the device with the numerically 
highest channel number as the operator terminal. 

. M4_SYSDEF will ask you to specify the type of device you 
plan to use as the boot device. 
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3. If you do not choose to suoply symbolic peripheral device 
(SPD) names, M4_SYSD£F automatically generates a unique SPD 
name for every device configured. If you choose to provide 
your own SPD names, M4_$YSDEF will ask you to specify them as 
needed. 

CII HONEYWELL BULL recommends that you use the following 
symbolic peripheral device (SPD) name conventions if you wish 
to provide your own SPD names* 


Symbolic 
Periphera1 
Device {SPD) 

Name Device 




/A 


► 



LPTnn 

Line Printer 

SPTnn 

Serial Printer 

CONnn 

MDC-connected Terminal 

CDRnn 

Card Reader 

CRPnn 

Card Reader/Punch 

OSK nn 

Diskette 

RCDnn 

Removable Cartridge Disk 

rCDnn 

Fixed Cartridge Disk 

rCMnn 

Fixed Cartridge Moduie Disk 

RCMnn 

Removable Cartridge Module Disk 

MSMnn 

Mass Strorage Unit 

MT9nn 

Magnetic Tape (9-track) 


4. CII HONEYWELL BULL recommends configuring Distributed Systems 
Facilities software e.g., File Transmission Facility HASP 
Workstation Facility, etc. after you have built your system 
the first time. This software is described in this manual's 
aooendixes. 

5. M4_SYSDEF doesn't support the following* 

. Configuration of dual-ouroose ooerator terminal 
. User-written line orotocol handler (LFHn) 

. Autocall Unit (ACU) 

. 7-track tape devices 
. Device or memory error logging 

6, The program converts all lowercase characters in your 
responses to uopercase characters, unless you enclose the 
lowercase characters In apostrophes ('). 

7, When you enter channel number assignments, the program 
verifies that* 


The channel number is In the proper format (i.e., that It 
contains exactly four hexadecimal characters and ends with 
either “00» or «80”) 


The channel number isn't already assigned to another device 
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. The channel number Isn't less than 0400 or greater than FF80 

Since there is no requirement that system building takes olace 
upon the target machine, or that any soeclfied device actually 
be attached to the machine when M4-SYS0EF Is executed, the 
orogram doesn't verify whether the specified channel is 
actually connected to a device whose tyoe matches the one In 
question. Therefore, if you enter Invalid channel number 
assignments, the directive file will be in error. 


MODIFYING YOUR CLM DIRECTIVE FILE 


If you make mistaskes In specifying your directives when running the 
M4_SYSDEF program, or, if you wish to change, add, or delete 
Information, you have several ootions for making modifications* 

. You can interrupt the program at any point to modify any 
portion of the CLM file. To do this, enter C B$H, and 
following the BREAK message, enter the program interruot t°I) 
conmand. CIt is assumed that you are entering the M4_SYSDEr 
program from the operator's terminal. If you are not at the 
operator's terminal, eress the BREAK key, and following the 
BREAK message, enter the PI command)» The M4 — SYSDEF orogram 
will respond by asking you which class of device or system 
parameter you wish to modify. Depending on your reply, the 
program will ask you only those questions in the M4_SYSQEF 
dialog that pertain to the specific device or system parameter 
that you wish to modify. 

. You can finish running the program and do one of the following* 

- Invoke M4_SYSDEF again, this time specifying the oathname of 
your restart file. The M4_SYSQEF orogram will enter rebuild 
mode and will ask you to specify the class of devices, or 
system oarameter that you wish to modify. See “Using 
M4_SYSDcF in Rebuild Mode," below. 

- Invoke M4_SYSDEF again and redefine the entire file. 

- Use the Editor to edit the file directly. 


USING M4_SYSDEF IN REBUILD MODE 

Using the M4^SYSDEF program in rebuild mode allows you to enter the 
program dialog at any point to make changes to an existing CLM file. 
The M4_SYSDEF program will only ask you those questions in the 
dialog that pertain to the specific device, class of devices, or 
system parameter that you wish to modify. Secause you need not step 
through the entire M4_SYSDSF dialog in sequence to get to the 
sectlon(s) you wish to modify, you can make random modifications 
quickly and easily. 
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The first time you create a CLM file using M4_SYSDEr, the program 
generates a CLM directive file and a file containing information for 
the rebuild function, called the restart file. Each time you modify 
a CLM file, the M4_SYSDEF program creates a unique corresponding 
restart file under the same directory as your CLM file.(l) Whenever 
you terminal the M4_SYSDEF program normally the full pathnames of 
your CLM file and its corresoonding restart file are displayed at 
your terminal. You never assign a name to the restart file - the 
M4_SYSDEF program does this for you automatically. You need only be 
aware of the pathname of the restart file that corresponds to the 
CLM directive file you wish to modify. 

If you wish to modify a CLM file at some later time, you simply 
invoke M4_SYSDEF and soecify the pathname of the corresponding 
restart file on the command line. The M4_SYSDEF program reads your 
restart file. See "M4„SYSDE.- Dialog In Rebuild Mode*' later in this 
section for a complete description of the rebuild mode dialog. 

( i) 

There is no limit to the number of restart files that the M4_SYSDEF 
program creates. You must delete restart files which are no longer 
needed with the delete file (DL) command, as described in the 
Commands manual. 


OinVdT OPTIONS 


You have several output options when using M4_SYSDEF* 

1. You can request W4_SYSDEF to list all the CLM directives it 
has built for you. If you spot any errors at this point (or at 

. any point during the Interactive dialogue) you can oerform any 
one of the actions described above under "Modifying Your CLM 
Directive File", 

2. You have the option of creating a CLM_USER file which contains 
the generated directives or you can terminate the Interactive 
session. If you have not listed the CLM directives and you do 
not wish to create a file using them, M4_SYSDEr warns you that 
the directives will be lost and oroeessing will terminate, and 
asks If this Is what you intend. 

3. You have the option of giving your directive file a name other 
than the default file name CLM_USER.(1) After you soecify a 
file name, M4_SYSDEF creates the file under your current 
working directory, assumed to be (but not restricted to> 
directory SID in the rest of this section. 

( 1 ) 

If a CLM file already exists In your working directory, M4_SYS0EF 
cautions you that your new CLM file will reolace the existing one. 
If both have the same file name. 
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Invoicing M4,5YSDEF 


Before Invoking M4_SYSDEF, you are reaulred to transfer control of 
the ooerator's terminal from the $$ task group (the system 
operator's task group) to the $H task group (a system-supplied user 
task group). (If the terminal Is already under control of the SH 
task grouo, proceed to the oaragraoh below that describes how to 
change your working directory to the directory SID.) Enter the 
following lines at the operators terminal immediately following 
system startup * 

C*$H*(Transfers control) of the operator's terminal from $S to $H 
task group) 

SDN (The ready on (RDN) command causes a orompt message to appear 
at your terminal. This command Is for convenience only and is 
not required). 

If you have entered RDN, the system will resoond with the prompt 
messagei , 


(SH)RDYi 

Note that no prompt message apoears unless you specified RON. 

'(ext, change your working directory to the directory SID by 
entering * 


CdD >SID 

Then invoke M4_SYSDEF by entering* 

M4_SYSDEF (path I 

where the optional argument (path] soeclfles the oathname of a 
system-supplied restart file. The pathname must be of the form 
M4RST.n inhere n Is an integer. You specify this argument only If you 
wish to enter the M4_SYSDEr program In rebuild mode to modify an 
existing CLM file. See M M4_SY$0EF Dialog In Rebuild Mode" later in 
this section. 


You can terminate the interactive session at any time by entering 
3$H and then, following the BREAK message, using the unwind (JW) 


command, (It is assumed that 
you are not at the operator's 
enter the UW command). If /ou 
directive file, follow one of 
this section under "Modifying 


you are at the operator's terminal, 
terminal, oress the BREAK message, 
make a mistake while creating the 
the options described elsewhere in 
Your CLM Directive File." 


If 




Prompt Moueb 


M4_SySDEr operates in two oromot modes - long and short. In the long 
mode, each question is preceded by a multiline onscreen explanation 
of the question being asked. In the short mode, only the question is 
asked. Users of the short oromot mode who need help can see the 
long explanation printed as a "help message" by askinq for helo (see 
below). 

M4_Sf3DEF asks you which mode you want to use when you invoke the 
orogram. If you select the long mode, the explanatory text anoears 
only once. If the program repeats the question (because, perhaps, 
you answered it incorrectly), the short prompt Is repeated unless 
you ask for help. It is recommended that first-time system builders 
execute M4_SYS0EF in the long prompt mode. 


M4_SYSDEr DIALOGUE 


The short mode prompt messages which make uo the M*_SYSDEF dialogue 
are listed below. In order of their aooearance. Unless otherwise 
noted, these resoonses are always acceptable* 

. ? - Help 

. YES or Y - Yes (for/yes/no questions) 

. NO or N - No (for yes/no auestions) 

* 0, NONE, or N - None (for questions requiring a numeric 
response) 

A response of [C/R] (RETURN) is never acceptable (i.e., there are no 
default resoonses). 

Once you invoke M4_SYS0EF, it responds with* 

Heiioi This tool will help you generate the file containing the 
Configuration Load Manager directives (the CLM_USER file), which is 
necessary to build your GCOS6/MOD400 Ooerating System. Do you wish 
to use the long oromot mode? 

. In the long mode, every prompt message Is preceded by the text 
of the "help" message, explaining what the reouested 
informat ion is, where you can find out if you have it or need 
it, and/or what will happen if you supply certain values. 

I 

In the short oromot mode, only the prompt message is displayed, 
unless you enter?. Entering? doesn-'t change the mode. 

. Acceotable answers are YES, Y, No, or N. 



rfhat is the total amount (in words) of real memory on the machine 
this system is to run on? Enter the value in the form* nnnk. 

. This value is the total amount of real (physical) memory 

installed on the machine for which this system is being built. 
The value you enter may differ from the amount of memory of the 
machine on which you invoke M4_SYSDEF. The minimum 
configuration for MOD 400 is 48K words. 

. Acceptable answers range 48K to 1024K. Consult Appendix C for 
information about minimum system requirements. 

Do you wish the system to supply the channel numbers for 
non-communication devices? 




. If you reply YES, the program will ask you to supply device 
types for the operator's console and the hoot device. 

. If you reply MO, the program will prompt you to supply a 
channel number for each device in your configuration, 

enter the channel number of the operator terminal which will he the 

CONSOLE. 

. You must specify the channel to which the ooerator's terminal 
is connected. M4_SY$DEr verifies for you that this channel 
number has not already been assigned to another device. 
However, only you can verify that the specified channel is 
actually connected to the terminal designated as the operator 
terminal for your Installation; l 44_SYSDEF cannot check this 
information for you. 

. The channel number specified must consist of four hexadecimal 
characters ending in '0(H or '80'. 

Enter the channel number of the boot device. 

o You must specify the channel number of the drive on which you 
mount the disk containing the system software. 

. The channel number specified must consist of four hexadecimal 
characters ending in > 00' or '80'. 

. This prompt does not appear If you specified that M4_SYSDEF 
will supply the channel numbers for all non-communications 
devices in your configuration. 





. Every peripheral device attached to the system must have a 
megabus channel number assignment. The program can use the 
floating channel feature (see Section V) to relieve you of the 
responsibility of assigning channel numbers to 
noncommunications devices; note, however, that you must always 
provide channel numbers for communications devices. 

. Acceptable answer are YES, Y, MO, or N. 
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Jo you wis i“> to t>oo t the fixed platter? 

. This promt applies only If you wish to boot from the fixed 
platter of a cartridge disk or cartridge module disk. 

• Acceptable answers are YES, Y, NO, or N. 

Is this a Commercial System? Reply "yes" or "no". 

. If you have a Model 47 or Model 57 central processor, answer 
YES. If you have any other model central orocessor, you must 
answer NO. 

. Acceptable answers are YES, Y, NO, or N. 

. If you respond NO to this question, the program replies* 
rtili this system have a Commercial simulator? 

. If your system isn't a commercial system, it may reauire the 

commercial instruction simulator. Otherwise, it won't he able 

to execute commercial instructions (used, for Instance, by 
immediate COBOL). 

. Acceptable answers are YES, Y, NO, or N. 
iVill this system have a SIR? Reply "yes" or "no". 

* The SIP is the Scientific Instruction Processor software 
oo tlon. 

. Acceptable answers are YES, Y, NO, or N. 

. If you reoly NO to this Question, the program replies* 

.Kill this system have a simulator for the SIP? Reply "yes" or "no". 

. Acceptable answers are YES, Y, No, or N. 

. If you reply No, then the system won-'t he able to suoport 
scientific Instruction (used, for Instance, In FORTRAN). 

. If you reply YES to this question, the oronram replies* 

Jo you want the double precision simulator SIPSIM? 

. Acceptable answers are YES, Y, No, or N. 

. If you reply yes, the double—precision simulator will give you 
twice as many significant digits in your FORTRAN calculations 
as the single-precision simulator. (If you chose this notion, 
be aware that numerical values stored In memory will take up 
twice as much soace as values stored for the single-precision 
simulator). 
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The default system Identification Is U CC()36/M00400 M . If you wish to 
change it, reply w YES H i If you do not wish to change It, reply “MO". 
Do you? 

. The system Identification message appears as a comment line 
near the top of the CLM file that M4_SYSDEF generates for you. 
fou may, if you wish, customize this message for your 
installation's CLM directive file. 

. Acceptable answers are YES, Y, NO, or N. 

. If you reoly YES to this question, the program replies* 

Enter the new System Identification (30 characters or less) In the 
form* 'SYSTEM.IDENTIFICATION' 

. fou must enclose the entire string in apostrophes, as shown. 

The default Installation Identification Is 'Your Town, USA'. If you 
wish to change it, reDly 'fSS'* If you do not wish to change it, 
reply 'No'. Do you? 

. The Installation identification message aopears as a comment 
line near the too of the CLM file that M4_5Y5D5r generates for 
you. You may. If you wish, customize this message for your 
installation's CLM directive file, 

. Acceptable answers are YES, Y, NO, or N. 

, If you reoly YES, the program responds* 

Enter the new installation identification (30 characters or less) in 
the form* 'Installation id' 

. fou must enclose the entire string in aoostrophes, as shown. 

Hlease enter the maximum number of concurrent users that you expect 
this system to supoort. 

. This value allows for the calculation of some of the system 
structure sizes and memory needs which vary deoending upon the 
maxi mum load for which the system is to be built. M4.SYSDEF 
assumes that the number of users is synonymous with the number 
of task groups. 

. Note that entering a given number here does not guarantee that 
the maximum number of concurrent users can In fact be 
supported. This depends on such dynamic variables as the work 
each user is oerforming and memory fragmeutation. 

• Monnumerle characters are not acceotable in this answer. 




Should I automatically generate the SPD names for you? 

. iach peripheral device attached to the system must have a 

symbolic perioheral device name. This entry is a five-character 
.Tame which conforms to the file system naming conventions. 

. Acceotable answers are YES, Y, MO, or N. 

. If you reply YES, the orogram will generate 5-character SPO 
names without further prompting. If you reply MO, the program 
will orompt you to supply an SPO name for every device in your 
configuration. 

Do you wish this system to activate the Record Locking Feature of 

Data Management? 

, Record Locking is the finest granularity of concurrency control 
orovided by data management. Activation of this runtime option 
allows more than one user to write records to a given file 
simultaneously. Proper usage of this ootioo ensures that all 
updates are correctly aoplied to the file. 

. Acceptable answers are YES, Y, MO, or N. 

. If you reply YES, record locking is Implemented. If you reoly 
Mo, data management will enforce file level concurrency <i,e., 
only one user can have write permission on a file at one time). 

Do you wish to include Display Formatting and Control Software? 

. The Display Formatting and Control software is described in the 
Display Formatting and Control manual and in Appendix P of this 
ma nua 1. 

. Acceptable answers are YES, Y, MO, or M. 

. If you reply, YES, the display processing software will be 
Included In your Executive. If you reoly MO, no diso lay 
processing software will be Included. 

Do you wish to activate the power fal1 restart? 

. This prompt asks If you wish to configure the power resumption 
facility. The power resumption facility allows the system 
execution environment to be restarted after a power 
interruption, if fewer than two hours have elasoed when power, 
is returned to the central processor, ror more information, 
refer to Appendix D. 

. If you reply YES, eacn ATD amd TTY communications 

(MLCP/DLCP-connected) device in your configuration will be 
automatically reconnected if a power resumption or line droo 
condition occurs. (Peripheral devices not attached to an 
4LCP/DLCP are automatically designated as reconnectable when 
they are configured). 
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. If you reoly M0 ( no automatic reconnectI on of 
MLCP/DLCP-connected terminal devices will occur. 

Joes this system have any communications tyoe devices? i.e., VIP's, 
TTY's, etc. 

. Acceptable answers are YES, Y, NO, and N, 

. A communications device is an WLCP/DLCP-conneeted device. 

. If you reply NO, the orogram skips to the prompt. u How many 
‘^DC-connected console devices do you have?' 1 , later in this 
dialogue. If you reply YES, you will see the following 
prompts. 

How many communications Driority levels <! to 4) do you wish? Enter 
the number of levels. 

. Each device must be assigned to a hardware interrupt level. 
Noncommunications devices must be assigned to unique interrupt 
levels; M4_SYSDHr can perform this assignment for you. 
However, communications devices can share a oriority level; 
therefore, you are given a chance to specify relative priority 
levels for each communications device. 


. Acceptable answers are 1, 2, 3, or 4. If you specify f, all 
communications devices will share one interrupt level. If you 
specify 2 through 4, you will have the caoability to assign 
specific devices to different levels, with those devices on 
level I having the highest relative priority and those devices 
Oa level 4 having the lowest relative oriority. You do not have 
to assign at least one devide to each level; M4_SYSDEF 
reserves any unused levels for you. 

How manu MLCP's (! to 10) will this system have? 


. All communications devices must be attached to a multiline 
communications processor (MLCP). 

. Acceptable answers are I through 10, inclusive. 


How nany ATOs do you have? 


. The program is now attempting to configure ail MLCP/DLCP 
connected asynchronous termina1 devices. 


. The following asynchronous terminal devices are supported* VIP 
7200, VIP 7205, VIP 7301, VIP 7302, VIP 7207, PRU1001, PRUI003, 
PRUIOOo, TWJIQOI, THU1003, TrVUlOQS, and various 
teleprinter-compatibia devices. 


. If you reply NONE, the orogram skios to the prompt, u How many 
VIP's do you have?, below. 

. If you reply with a nonzero number, the orogram continues* 
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ATO terminal number N 


• This message, and the three promot following it* aooear N 
times* where Mis your resoonse to the earlier question, “How 
nany ATJs do you have? 14 . 

What channel number will tnis device be on? 

. fou must enter exactly four hexadecimal characters* ending in 
"DO" or "80". 

inter the communications priority level for this terminal. 

. Acceotable answers range from I through your resoonse to the 
earlier question, l4 How many communications priority levels ( I 
to 4) do you wish?". 

. If you soecified only one communications orlority level* this 
orompt won't aooear. 

What is the Jevice tyoe for this ATD device? 

. fou must specify one of the following values (there is no 
Jefaui t) * 

Physical Device Type 


VIP 7200, VIP 7205 
VIP 7801 * VIP 7802 
VIP 7207 

PRU PRO 1001* PRUI003, PRO 1005, 

TWU 1001*. TWUI003* TWO 1005, 

TFY Can be any asynchronous terminal device-type 

classified as teleprinter compatible. 

how many VIP's do you have? 

. The program is now attempting to configure synchronous 

terminals. The following synchronous terminals are suooorted 
oy M4_5 YSDEFi 

VIP 7700 

VIP 7700R/VIP 7705R 
VIP 7740 

VIP 7304/VIP 7805 (in VIP 7700 mode) 

. To use the extended features of the VIP 7804 or VIP 7805* you 
.nay want to use an STD directive. STD groups are configured 
later on in the '<(4_SYSDEr dialog. 

. If you reply 0* the program skios to the oromot, "How many 
H3270 Host Links do you have?", below. 
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Value 
7200 
7801 
J 7200 


I 





. If you reply with a nonzero number, the Drogram continues* 

j* 

VIr> terminal number N 

. this message, and the seven Dromots following It, appear N 
times, where N Is the number you entered In resoonse to the 
earlier question, "How many VIP's do you have?". 

4hat channel number will this device be on? 

. fou must provide the Megabus channel number to which this 
device is attached. 

. You must enter exactly four hexadecimal characters, endlno In 
"00" or "80". 

■low many VIP's are soiled on this channel? 

. ? is not acceptable here. 

. Acceptable answers are the numbers 0 through 31, inclusive. 

inter the communications orlorlty level for this terminal. 

. ? is not acceptable here. 

. Acceptable answers range from 1 through your response to the 
earlier question, “How many communications orlorlty levels (1 
to 4) do you wish?“. 

* If you specified only one communications priority level, this 
pront .von't appear. 

inter the polling address for this VIP. 

. Acceptable answers are 0 through 31, inclusive. 

. This promt aooears only If you specified a non-zero value for 
the prompt "How raanu VIP's are polled on this channel?", above. 

Is this VIP a "Control Station"? 

. ? is not acceptable here. 

. Acceptaoie answers are YES, Y, No, or N. 

Joes this VTP have a ROP <receive-Only Printer)? 

. Acceptable answers are YES, Y, NO, or N. 

. If you reply NO, the oroqram skins tne next two prompts. If you 
reply YES, the program continues* 
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rthat type of ROP do you have? 

. There are eight suooorted ROPs * 


Soecify One 


Devices Supported 
(See Appendix C) 


4 . 


in no 

TN300 (default) 
TN1200 
TTY 33 
TTY35 


TermlNet 100 or PRU 1001 
TermiNet 300 or PRU 1003 
TermiNet 1200 or PRU 1005 
ASR-33 
ASR-35 


Joes this ROP support form feed? 

. ? is not ecceotable here. 

. Acceptable answers are YES* Y, No, or M. 


How many H3270 Host Links do you have? 

. The program is now attempting to configure stations for the BSC 
3270 line protocol handler in your configuration. 

. Acceptable answers are a nonzero number or NONE. 

. If you reoly NONE, the program skips to the orompt, "How many 
PVE groups do you have?", below. 

. If you reply with a nonzero number, the program continues* 


H3270 line number N 


. This messages, and the 4 prompts following it* aooear N times, 
where N is the number you entered in response to the earlier 
question, "How many H3270 Host Links do you have?". 

Nhat channel number will this line be on? 

. fou must provide the Megabus channel number to which this line 
Is attached. 

. You must enter exactly four hexadecimal characters, ending in 
"00" or "80". 


Enter the communications priority level for this line. 

. ? is not acceptable here. 

. Acceptable answers range from 1 through your response to the 
earlier question, "How many communications oriority levels (1 
to 4) Jo you wish?". 

. If you specified only one communications priority level, this 
pronpt won't appear. 
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Enter the polling address (decimal) for this H3270 Host Link 


. 7 Is not acceptable here. 

. Acceptable answers ranje from 0 through 255, Inclusive, 

M4.SYSDEF converts this number to a hexadecimal value for you 
when it defines the H3270 directive. 

Enter the select address (decimal") for this H3270 Host Link, 

. 7 is not acceptable here, 

. Acceptable answers range from 0 through 255, Inclusive, 

M4_SYSDEF converts this number to a hexadecimal value for you 
when it defines the H3270 directive. 

How many PVE groups do you have7 

. The program is now attempting to build facilities for polled 
VIP emulated (PVE) groups into your configuration. (I) 

. If you reply “NONE", the orogram sklos to the prompt, “How many 
STD groups do you have?", 

* If you reply with a nonzero number, the program continues* 

PVE grouo number N 

. This message, and the four prompts following It, appear N 
times, where N is your response to the earlier question, “How 
many PVE groups do you have?". 

Enter channel number for PVE group N 

. ? is not acceptable here. 

. You must enter exactly four hexadecimal characters, ending In 
»00" or "80". 

How many PVE stations are there in this channel? 

. 7 is not acceptable here. 

, Acceptable answers are ) through 32. 1nclusive. 

Enter the communications priority level for this group. 

. ? is not acceptable here. 

. Acceptable answers range from \ through your response to the 
earlier question, "How many communications priority levels (i 
to 4) do you wish?". 


( 1 ) 

A PVE consists of all the PVE stations assigned to the same 
hardware channel. 
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. If you specified only one communications oriority level, this 
prompt won't appear. 

Enter the polling address (0 to 31) for ?VE station N 

, ? is not acceptable here, 

. Acceptable answers are 0 through 31, inclusive. 

♦ The prompt appears N times, where N is your response to the 
earlier question, "How many PVE groups do you have?". 

How many STD groups do you have? 

, The program is now attempting to configure ail MLCP/DLCP 
connected synchronous terminal devices. 

. The following synchronous terminal devices are supported* VIP 
7804, VI? 7805, VI? 7700, VIP 7700R, VIP 7705R, and VI? 7760. 

. If you reply NONE, the program skips to the prompt* "How many 
VLCP-connected Binary Synchronous Communications (BSC) lines do 
you have?", below. 

. If you reply with a nonzero number, the program continues* 

STD grouo number N 

. This message, and the 8 prompts following it, appear N times, 
where N is your response to the earlier question, "How many STD 
groups do you have?". 

Enter channel number for STD group N 

. You must enter exactly four hexadecimal characters, ending in 
"00" or "30", 

Enter the communications priority level for this group 

. Acceptable answers range from I through your response to the 
earlier question, "How many communications priority levels <J 
to 4) do you wish?". 

. If you specified only one communications priority level, this 
orompt won't aooear. 

How nany STD stations are there on this channel? 

. The reply "?" is nor acceptable here. 

. Acceptable answers are I through 32, inclusive. 

Enter the polling address (0 to 31) for STD station N 

. ? is not acceptable here. 
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, Acceptable answers are 0 through 31, inclusive, 

. The prompt appears N times, where N is your response to the 
earlier auestion, "How many STD groups do you have?", 

rthat is the device type for this STD device? 

. You must specify one of the following device types* 

Device type Supported Devices 


V78Q4 VIP 7804, VIP 7805 

V7700 VIP 7700, VI.P 7700R, VIP 7705R 

V7740 VIP 7760 


Joes this STD have a ROP (Recei ve-only printer)? 

. If you reply NO, the program skips the next promot. 
If yog reply YES, the program continues* 

rfhat type of ROP do you have? 


, There are four supported ROPs* 


Specify One 


Devices Supported 


ROSY24 
R0SY26 
TN300 
TNI 200 


PRU 1003 
PRU 1005 
TermiNet 300 
TermiNet 1200 


How many MLCP-connected Binary Synchronous Communication (BSC) lines 
do you have? 

• The program is now attempting to build facilities for BSC lines 
into your configuration, 

• ? is not acceptable here. 

. If you reoly 0, the program skips to the prompt, "How many 
MDC-connected console devices do you have?", below. 

• If you reply with a nonzero number, the program continues* 

BSC line number N 

. This message, and the three prompts following it, appear N 
times, where N is your response to the earlier question, "How 
many MLCP-connected BSC lines do you have? 1 '. 

4hat channel number will this device be on? 

. ? is not acceptable here. 

. You must enter exactly four hexadecimal characters, ending in 
"00" to “80". 
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Enter the communications priority level for this terminal. 

. ? is not acceotabie here. 

. Acceptable answers range from 1 through your response to the 
earlier auestion, "How many communications priority levels (1 
to 4) do you wish?". 

. If you specified only one communications oriortty level, this 
oromot won't apoear. 


Is this 3SC line a "Primary" one. 

. 7 is not acceptable here. 

. \cceotaole answers are YES, Y, No. or N, 

How nany WOC-conaeeted console devices do you have? 

. Pie orogram is now attempting to build facilities for all 
'■UC-connected teminai devices. 

. If you reoly NONE, the orogram skips to the prompt, “How many 
dls<ettes do you have?", below. 

. If you reply with a nonzero number* the orogram continues* 


CON number 1 

rthat channel number will this device be on? 

. This prompt appears only if you are exolicltly entering channel 
numbers. 

. This oromot aopears N times, where N is your response to the 
earlier question, "How many MDC-connected console devices do 
you ha ve ? ". 

. You must enter exactly four hexadecimal characters, ending in 
"JO" or "dO". 
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rthat Is the device type for the Operator's CONSOLE? 

. fou must soeclfy one device as the Operator's temrlnal* 

Value Physical Device Type 

7200 VIP 7200 (DKU9I03) 

VIP 7205 (DKU9102) 

The value 7200 must be used If MDC- 
connected VIP 7200 terminals are to 
be used for forms processing using 



the Display formatting and Control 
facility. 

PRU 

P RU1 003/P RU1005/TWU1003/TOU1005 

D7200 

VIP 7207 

KSR 

The terminal is to be supported in 
teleprinter mode. 

7301 

VIP 7301, VIP 7302 


CON number N 

. This message, and the two oromots following it, appear N - l 
times, where N is your response to the earlier question, “How 
many MQC—connected console devices do you have? 1 *, 

Nhat channel number will this device be on? 

. fou must enter exactly four hexadecimal characters, ending in 
“00“ or "30“. 

. This oromot aopears only if you are explicitly entering channel 
numbers. 

. ? is not acceotable here, 

What is the device type for this CON device? 

, Specify one of the values Dreviously described for CON number 
i. 

How many diskettes do you have? 

. The program is now attempting to build facilities for diskette 
devices into your configuration, (See Appendix C for a list of 
diskette device), 

. If you reply 0, the orogram skips to the prompt, “How many 
cartridge disks to you have?", below. 

. If you reply with a nonzero number, the orogram continues* 
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Diskette number N 


What channel number will this device be on? 

. This promot only appears if you are explicitly entering channel 
numbers. 

. This promot aopears N times, where N is your response to the 
earlier ouestion, “How many diskettes do you have? 1 '. 

. ? is not acceotable here. 

. You must supply exactly four hexadecimal characters, ending in 
“00“ or “30". 

How many cartridge disks do you have? 

• The program is now attempting to build facilities for cartridge 
disk devices into your configuration. (See Appendix C for a 
list of cartridge disx devices). 

. four configuration must have at least one cartridge disk, 
cartridge module disk, or mass storage unit. 

. If you reply 0, the program skios to the prompt, “How many 
cartridge module disks do you have?", below. 

. If you reoly with a nonzero number, the program continues* 

Cartridge Disk number M 

. This message, and the two oromots following It, appear N times, 
where N is your response to the earlier question, “How many 
cartridge disks do you have?'*. 

what channel number will this device be on? 

. This orompt only appears If you are explicitly entering channel 
numbers. 

. 2 is not acceptable here. 

. You must suoply exactly four hexadecimal characters, ending in 
<*00“ or “80". 

Does this Catridge Disk have a fixed oiatter? 

. ? is not acceptable here. 

. Acceptable answers are YES, Y, HO, or N. 
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How many cartridge module disks do you have? 

» The program is now attempting to build facilities for cartridge 
module disks into your configuration. (See Appendix C for a 
list of cartridge module disks). 

. If you reply 0, the program skies to the prompt* "How many 
storage modules do you have?", below. 

. if you reply with a nonzero number, the program continues* 
Catridge Module Disk Number N 
rihat channel number will this device be on? 

. This nromot only appears if you are explicitly entering channel 
numbers 

. This prompt appears N time, where N is your response to the 
earlier question, "How many cartridge module disks do you 
have?". 

. ? is not acceptable here. 

. fou must supply exactly four hexadecimal characters, ending in 
"00" or "80". 

How many storage modules do you have? 

. The program is now attempting to build facilities for mass 
storage devices into your configuration. (See Appendix C for a 
list of mass storage devices). 

. If you reply NONE, the program skips to the orompt, "How many 
card reader/punches do you have?", below. 

. If you reply with a nonzero number, the program continues* 
Storage Module number N 

rfhat channel number will this device be on? 

• This prompt only appears if you are explicitly entering channel 
numbers. 

. This prompt appears N times, where N is your response to the 
earlier question, "How many storage modules do you have?". 

. ? is not acceptable here. 

. fou must enter exactly four hexadecimal characters, ending in 
"00" or "80". 
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How many card readers do you have? 


. The program is now attempting to build facilities for card 
reader devices into your configuration. (See Aopendix C for a 
list of card reader devices). 

• If you reply 0, the program skips to the prompt, "How many card 
reader/punches or punches do you have? M , below. 

. if you reply with a nonzero number, the program continues* 

Card Reader number N 

■ V 

rthat channel number will this device be on? 

. This oromot only aopears if you are explicitly extering channel 
numbers. 

. This prompt appears N times, where N is your response to the 
earlier question, "How many card readers do you have? 11 . 

* 

. ? is not acceptable here. 

. You must suoply exactly four hexadecimal characters, ending in 
“00“ or ‘'80". 

How many card reader/ounches or punches do you have? 

• The program is now attempting to build facilities for card 
reader/punch devices or card punch devices into your 
configuration, ^ote that "card reader/punch" doesn^t mean card 
readers or card punches, but devices that both read and punch 
cards. (See Aopendix C for a list of card reader/punch 
devices). 

. If you reply 0, the program skips to the orompt, "How many 
printers do you have?", below. 

. If you reply with a nonzero number, the program continues* 

Card reader/punch or punch number N 

rthat channel number will this device be on? 

. This oromot only aopears if you are explicitly entering channeL 
numbers. 

. ? is not acceptable here. 

. This oromot aopears N times, where N is your response to the 
earlier question, "How many card reader/ounches or punches do 
you have? 11 . 

. You must suDply exactly four hexadecimal characters, ending in 
"00" or "30". 


I 
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How many printers do you have? 


. The program is now attempting to build facilities for line 
printer devices into your configuration., (See Appendix C for a 
list of line printer devices). 

. If you reply 0, the program skips to the prompt, "How many 
9-track magnetic tape device do you have?", below. 

* If you reply with a nonzero number, the program continues* 
Printer number N 

What channel number will this device be on? 

; This prompt only appears if you are explicitly entering channel 
numbers. 

. This prompt appears N times* where N is your response to the 
earlier question, "How many printers do you have?", 

. ? is not acceptable here. 

. You must suoply exactly four hexadecimal characters, ending in 
"00" or J, 80". 

How many 9-track magnetic tape devices do you have? 

. The program is now attempting to build facilities for 9-track 
magnetic tape devices into your configuration. (See Appendix C 
for a list of 9-track magnetic tape devices). 

. If you reply 0, the program skips to the prompt "do you wish to 
have ALL system overlays resident (yes or no)?", below. 

. If you reply with a nonzero number, the program continues* 
Magnetic Tape Device number N 
What channel number will this device be on? 

. This prompt only aopears if you are explicitly entering channel 
numbers. 

. This prompt appears N times, where N is your response to the 
earlier question, "How many 9-track magnetic tape devices do 
you have? 

. ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, ending in 
«00« or "80". 
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Do you wish to have ALL system overlays resident? (yes or no) 

. Acceptable answers are YES, Y, MO, or N« 

. If you amswer yes, the system optimizes the execution speed of 
all functions* the resulting system will occupy more memory 
than a system without resident overlays. The program skips to 
the prompt, u Do you wish to create a batch memory pool?**. 

. If you answer no, the program continues* 

Do you wish to ootimize the reading/writing of relative files? 

. 3y making particular system input/output overlays permanently 
resident, you can obtain optimum soeed for selected file types. 
This oromDt, and the six that follow, ask if you wish to 
optimize the execution speed necessary to perform different 
functions. 


. Acceptable answers are YES, Y, NO, or N. 

* 

Do you wish to ootimize the reading/writing of random files? 

. Acceptable answers are YES, Y, MO, or M. 

Jo you wish to optimize the reading/writing of indexed files? 

. Acceptable answers are YES, Y, NO, or N. 

Do you wish to optimize releative files with deietable records? 

. Acceptable answers are YES, Y, NO, or N. 

Do you wish to optimize file management ooen/close functions? 

. Acceptable answers are YES, Y, MO, or N. 

Do you wish to optimize the reading/writing of tape files? 

. Acceptable answers are YES, Y, MO, or N. 

. This prompt appears only if you orevlously specified that your 
system suooorts magnetic tape devices. 

Do you wish to optimize EBCDIC tape functions? 

. Acceptable answers are YES, Y, Mo, or M. 

Do you wish to create a batch memory pool? 

. Acceptable answers are YES, Y, Mo, or M. 

. If you answer no, the orogram skios to the prompt, "Enter the 
number (I to 10) of 320-word system overlay areas you desire", 
oelow. If you answer yes, the orogram continues* 
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How big a batch pool? (nnnnn or nnk words) 

. Nonnumeric characters (except for J, k") are not acceptable here. 

, You must supply a numeric value of the form nnnnn or nnk words 
Enter the number (I to 99) of system overlay areas you desire. 

. Nonnumeric characters are unacceotable here. 

. the number of system overlays that you specify will be loaded 
into the system area of memory where they will remain resident 
for the duration of the configured system. The larger the 
number of system overlays is. the more likely it is that 
frequently used system overlays will be found in memory. 

Would you like to see the generated statements? 

. Acceptable answers are YES f Y, NO, or N. 

. If you answer yes, M4_SYSDEF lists the contents of the file of 
CLM directives it has generated for you. At the top of the 
listing (below the SYS directive statement) the program 
identifies for you the version of M4_SYSDEF that you are using, 
as well as the date and time that your CLM directive file was 
genera ted. 

. If you spot an error at this point, you can enter rebuild mode 
by hitting the break key and then typing the command PI 
(orogram interruot)• See "M4_SY$DEF Dialog In Rebuild Mode* 1 
later In.this section. 

. If you answer no, the program continues* 

Do you want to create a CLM directive file now? 

. Acceptable answers are YES, Y, No, or N. 

. If you reply no to both this question and the preceding 
question, the program warns you that the directives will be 
lost and processing will terminate, and asks if this Is what 
you Intend. If you reply yes, this is what you intend, 
processing terminates, and no directive file is created. If you 
reply no, the previous question, "would you like to see the 
generated statements?'*, is repeated. 

. If you reply no to this Question but replied yes to the 
preceding question, processing terminates. 
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• If you reply yes, the M4.SYSDEF program automatically generates 
a map file for you containing configuration information you may 
find useful. (For a complete exoianation of the map file, refer 
to the descriotion of the MAP directive in Section V), The 
program assigns this map file the pathname >SID>CLM_MAP. If you 
wish to examine CLM.MAP after you create your CLM file, you can 
use a print (PR) command or invoke the Editor and use the 
Editor's read and print directives. 

. If you reply yes, the orograra continues* f 
Would you like to use a file name other than CLM.USER for this file? 

, Acceptable answers are YES, Y, MO, or M. 

. You may wish to use the default file name CLM_USER or a file 
name of your own. If you answer no, M4.SYSDEF creates CLM.USER 
under your current working directory SID and processing 
terminates. 

. If this file already exists in your current.working directory, 
M4_SYSDEr Informs you and gives you the option of quitting, 
re-writting the file, or providing another file name, 

. Mote that although you are free to rename your CLM file, the 
system must be able to locate a file named CLM.USER under 
directory $ID at system startup. Remaining your CLM file allows 
you the option of creating more CLM files than just the one 
your system needs at configuration time. You may, for examole, 
be creating CL.M files for several installations, in which case 
you may want each one to have a unique name for identification 
purposes. 

. If you answer yes, the program continues* 

Enter your filename — 

. The file name you choose must be no longer than (2-characters 
and must conform to standard file name convent ions, 

. After you enter your file name, M4.SYYSDEF creates your CLM 
file under your working directory 510, and processing 
terminates. The program lists the full pathnames of the CLM 
file a.Td its corresponding restart file at your terminal,. If, 
at some later time you wish to modify your CLM file, see "Usinq 
44.5YSDEF in Rebuild Mode", earlier In this section, 

. If this file already exists in your current working directory, 
M4.SYSDEF informs you and gives you the option of quitting, 
re-writing the file, or providing another file name. 


I 
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M4_SY5P£F OIALOG IN REBUILD MODE 


Once you invoke M4_SYSDEF and specify the pathname of a restart 
file, the program responds with* You have entered M4„SYSDEF in the 
rebuild mode. Do you want to see the existing CLM statements? 

. If you respond YES, the program lists the CLM directives 
contained in your restart file. 

. If you respond NO, the program continues* 

Do you wish to modify devices or system parameters? 

Respond with "SYSTEM", "DEVICES", "VIEW", or "DONE". 

Response * 

. Depending on your resoonse, the Drogram will enter the 
M4_SY3DEF dialog at the appropriate place so you can make 
modifications. Table 4—1 lists each question and response in 
the rebuild mode dialog. The comp late M4_SYSDEF dialog is 
described earlier in this section. 

. If you respond SYSTEM, the program asks the question, "Do you 
wish to modify the prompt (PROMPT), memory size (MEMORY), the 
number of interactive users (USERS), the automatic generation 
of SPD names (SPD), the automatic channel assignment (CHANNEL), 
the record locking feature (RLOCK), the system overlay areas 
(SOAT), the resident overlays (RESOLA), the display formatting 
feature (VDAM), the commercial or SIP simulators (SIMUL), or 
the system and Installation identification (IDENT) ? Depending 
on your response to this question, the program will enter the 
M4_SY$DEF dialog at the appropriate place so you can make 
modifications. Once you have finished making your 
modifications, enter the reoly DONE. 

. If you respond DEVICES, the program asks the question, "Respond 
with the device type or class that you wish to modify. "COM.M", 
"CON", "DSK", "RCD", JI MSM", "CMD", "CDR", "CRP", "LPT", "MTP", 
or "DONE". Deoending on your response to this question, the 
program will enter the M4_3YSDEr dialog at the appropriate 
Diace so you can make modifications. If you reply DONE, the 
program will repeat the prompt, "Do you wish to modify devices 
or system parameters?" When you have finished making your 
modifications, enter the reply DONE. 

. If you reply VIEW, the program lists the current CLM file at 
your terminal. 

. If you reply DONE, the program skips through the M4_SYSDEF 
dialog to the promot, "Would you like to see the generated 
statements?" Normal M4_SYSDEF termination orompts follow. 
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. d hen M4_SYSDEF processing terminates normally, the program will 
list the pathnames of your CLM directive file and its 
associated restart file. If you wish to modify this CLM file at 
some later time, you invoke M4..SYSDEF, specifying the pathname 
of this restart file on the command line. 

Table 4-1 lists each question and response in the rebuild mode 
dialog. Using this table, you can trace each of your possible 
resoonses to a specific entry point in the M4_SYS0EF program dialog. 

To use this table, begin in the left hand column and read across to 
the right. Note that the questions you are required to answer become 
more specific as you isolate the specific section of the M4_SYSDEF 
dialog that you wish to enter. The fifth column lists the actual 
questions in the M4_SYSDEF program dialog that aopear as a result of 
your response to previous rebuild mode questions. Column six lists 
the pages in this section of the manual that explain each M4_SYSDEF 
question l.i detail. 






Table 4-1 (Oont). Rebuild Mode Dialog 





EXAMPLES OF M4_SY5P£F USAGE 


The following examoles illustrate how you can first create a CLM 
directive file and then modify it at some later time by invoking 
M4„SYS0EF in rebuilt mode* Example 1 steps through the entire 
M4_SYSDEF dialog. Example 2 illustrates the rebuild mode dialog. 

Example 1 * 

Following a Stage 1 (initial) system startup, a new user wishes to 
create a CLM file using M4_SYSDEF. Prior to invoking M4„SYSDEF, the 
user must transfer control of the operator's terminal from the $S 
(system) task group to the supplied user task group $H* 

lCi«SHs 

ft 

The terminal is now under control of the SH task group. The user 
wishes to see the ready prompt message, and so enters the RDN (ready 
on) command* 


RDN 


The system responds* 


(SH )RDY * 

The user invokes M4„SYSDEF and defines a CLM file* 
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M4.5YS0EP 

H€LL01 THIS TOOL MILL HELP TOO GENERATE THE FILE CONTAINING 
THE CONFIGURATION LOAQ MANAGER DIRECTIVES (THE CLM_U3ER FILE). 

WHICH IS NECESSARY TO HUILO YOUR GCOSG/MOOftOO OPERATING SYSTEM, 

00 YOU WISH TO USE THE LUNG PROMP1 MODE? 

7 

THERE are Two MOOES IN which T.U RUN This TOOL* THE LUNG 

MODE ANO THE SHORT MUOt. IF YOU PlC* ThC LUNG MQOt* EVENT PROMPT 

MESSAGE WILL HE PRECEDED BY AN EXPLANATION OF WHAT I HE REQUESTED 

INFORMATION IS* WHERE YOU CAN FIND TH£ REQUESTED INFORMATION* ANO 

WHAT WILL HAPPEN JF TUU SUPPLY CERTAIN INPORMAtION, Th£ SMURT HUOt SHUULD 

BE USEO BY PEHSOLS WHU HAVE BUILT This SYSTEM BEFORE ANQ 00 NOT NEED 

TH£ LONG PROMPT Tt*T. IF YOU SELtCT THt SHORT MODE ANO THEN UNO 

THAT YOU NtEU HELP IN ANSWERING ONE OF THE QUESTIONS* YUU Can OBTAIN 

THE LOnG MUliE TE«t BY ENTERING A ' 'f ' J This WILL NUT CHANGE THE MODE 

ANO ALL SUBSEQUENT QUESTIONS WILL*B£ UF THE SHORT FUNM, 

SINCE THIS IS A GENERALIZED TUOL* CERTAIN COMMUN DEFAULTS HAVE BEEN 
ASSUMED; if YUUR SYSTEM REQUIRES A CHANGE TU THESE DEFAULTS* YUU CAN 
GENERATE Tnt ’CLM.UStR* FILE ANO IH£N USE THE STANOAHO EDI TUP 
TO MAKE THESt MCUIFICATIMNS, GUQO LuCK, 

00 YUU WISH TU USE THt LUNG PRUMP1 MUD tt 
YES 

THE TUTAC AMOUNT UF REAL* PHYSICAL HEMURY INSTALLED UN THE MACHINE 
FUR WHICH THIS SYSTEM IS BEING BUILT MAY BE QIFFtREM FROM 
THE MEMORY AVAILABLE ON THE MACHINE YOU AWE CURRENTLY USING, 

THE MINIMUM CONFIGURATION FOR GCOSG/MOU40Q IS *464’ WOROS. 

WHAT IS Thft TOTAL AMuUNT (IN wO«OS) UF WE*L M£MUHY UN THE MACH1Nt THIS 
SYSTEM IS Tu HUN UN? ENTER THE VALUE-* JN TH£ FUHMI NNNK . 

12BK 

IF' YOU WISH, «E CAN GENERATE The ClM DIRECTIVES WlTHuuT SPECIFYING 
THE CHANNEL NUMHtMS FUR NHN-CUMHUN1C*TIUN TYPE UtVILtS, FUH 
COMMUNICATION DEVICES you MUST ALWAYS PRUVIOfe A CHANNtL NUMBER. 

AT SYSTEM STAHT-UP UmE, THg SYSTtM WILL POLL Tut HANUwARt ANU 
DETERMINE UPON WHICH CHANNEL EACH DEVICE IS LOCATED. 

OO YUU WISH THE SYSItM TU SUPPLY IH£ CHANNEL NUMdtRS FUK 
NUN-COMMUNICATION ObVICES? 

NO 


ENTER THE channel NUMBER UF TH£ uPEWaTOR TERMINAL 

WHICH wUL tf£ THk CONSOLE 
0400 

ENTER THt CHANNEL NUMBER UF THE bOOT ObVICt 
1 400 

DO YUU wISH TO HUUr THE FU£0 PLAIT£R? 

NO 
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A COMMERCIAL SYSTEM is a MODEL a/ QR MQOEL $7. 

1$ THIS A COMMERCIAL SYSTEM? REPLY "YES" QR "NU." 

N 

SINCE YOU DO NOT HAVE A COMMERCIAL SYSTEM' HILL YOU 
HAVE THE COMMERCIAL SIMULATOR! IP YOU REPLY 'NOS THEN 
THIS SYSTEM HILL NOT SE ABLE TO SUPPORT COBOL. 

HILL THIS SYSTEM HAVE A COMMERCIAL SIMULATOR? 

Y 


sip means'scientipic instruction processor*. 

HILL THIS SYSTEM HAVE A SIP? REPLY "YES" OR "NU.* 

N 

SINCE YOU DU NOT HAVE THE ’SCIENTIFIC INSTRUCTION PRUCESSUH', HlLl YOU 
HAVE THE SIMULATOR FOR THIS HARDWARE OPTION? IF YUU REPLY 'NU',‘ IHfcN 
THIS SYSTEM HILL NOT BE ABLE TO SUPPORT ANY OF I HE SCIENTIFIC 
INSTRUCTIONS. 

HILL THIS SYSTEM HAVE A SIMULATOR FOR ThE SIP? REF'LT "YES" (IM "NU." 

YES 

DO YOU HANT THE OQUbLE PRECISION SIMULATOR SIPSIM? 

NO 

THE SYSTEM IDENTIFICATION IS ONE UF THE STANOAHQ PAHTS OF THE CUMMENT 
STATEMENTS THIS UTILITY AUTOMATICALLY GENERATES. 

IF YOU ENTER A NEh VALUE MAKE SURE IT IS ENCLOSED HXTHIN 
APOSTROPHE MARKS UR SOME OF Th| INFORMA IXUN MAY BE LUST. 

THE DEFAULT SYSTEM IUENTIF 1CATION IS • GCOSft/MOD«UV 
IF YOU hISH TU CHANGE IT, REPLY ’YES*! IF YOU UU NUI HlSH TO 
CHANGE IT, REPLY 'NO*. UO YOU? 
r 

ENTER THE NEH SYSTEM IDENTIFICATION (30 CHARACTERS 0" LfcSSJ IN THfc FORM 
’SYSTEM^IOEnTIFICATIUN’ 

’GC03N/MO0 «00 VERSION 2.1* 

THE INSTALLATION IDENTIFICATION IS ONE UF THE STANDARD PARIS UF IHfc 
COMMENT STATEMENTS THIS UTILITY AUTOMATICALLY GENERATES. 

IF YOU ENTER A Nfc* VALUE, MAKE SURE IT IS ENCLOSED 

WITHIN APUSTRUPHr. MARKS OR SOME QF TH£ INFORMATION MAY HE LUSl. 

THE DEFAULT INSTALLATION IUENTIF RATION IS * YOUR TURN, USA'. 

IF YOU * 1SM TO CHANCE IT, REPLY ’TfcS’l IF YUU DU NuI *ISh TO 
CHANGE IT, REPLY 'NO'. DO YOU? 

YES 

enter the Nt r installation identification (Jv charaliens or ttssj 

IN THE FORMS ’INSTALLATION ID' 

•TEST SITE UNP * 

THE NUMHER OF CONCURRENT USERS ASSISTS IN THE CALCULATION OF SYSTfcM 
STRUCTURE SUES AND MEMORY NEEDS amiCh VARY UfcPkNOlNG 
UPON THE MAXIMUM LUAO THE SYSTEM IS TO BE CUNF1UUREU 
FOR. THERE IS, HOWEVER, NO nAY TU ENSURE THAT THE MAXIMUM 
NUMBER OF USERS THAT YOU SPECIFY HERE HILL INOtEU 
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BE THE max. NUMB EH UF USERS THE StSTEm WILL SUPPURT, THIS DEPENDS 
ON SUCn DYNAMIC VARIABLES as THE WORK EACH USER IS PtRFURMlNG. ANU 
MEMORY FRAGMENTATION* 

please ENTER The maximum NUMBER op CONCURRENT users that tuu 

EXPECT THIS STSTfcM !U SUPPORT. 
h 


EVERY PERIPHERAL DEVICE ATTACHED Ty TnIS STSTtM MUST HAVE A 
SPO (SYMBOLIC PERIPHERAL OEVICE) NAME. THIS NAMt IS A 
UNIQUE t> CHARACTER (MAXIMUM) NAME WHICH CONFORMS TO THE FILE SYSTEM 
NAMING CONVENTIONS. IF YUU REPLV ’YES' HERE. I PILL GENERA Tt THtSE 
NAMES FOR YOU WITHOUT ANY FURTHER PROMPTS. IF YUU REPL Y *Nu'. I MILL 
ASK YOU TO SUPPLY TmE SPD NAME FUR E*CH ANO EVERY UtVICE AS wt 
CONF IG'JRt That OtV ICE 

SHOULD I AUTOMATICALLY GENtRATE Trrt SPO NAMES FUR YOU? 

Y ’ - 

RECORD LUCKING IS The FINEST GRANULARITY OF CONCURRENCY CONTROL That 
DATA MANAGEMENT PROVIDES. ACTIVAHijN OF THIS RUN-UHt UPIIUN PROVIDES 
TOOLS TO ALLOW M'JRE Than ONE USER To WRITE RECORDS KJ A GIVEN FILE at 
THE SAME HMfc. PROPER USAGE OF THIS OPTION INSURES THAT ALL UPDATES 
ARE COHRtCTLY A PPLItO TO THE FILE. IF YOU REPLY "TtS", THIS OPTION WILL 
BE AVAILABLE. If YOU REPLY “NO*, IHtN DATA MANAGEMENT «ILL ENFORCE 
FILE LEVEL CONC'JRwEnC Y, l.fe. ONLY UNE USER WITH wRUE PERMISSION TO A FILE. 
DO YOU WISH THIS SYSTEM TU ACTIVATE THE RECUHO LUCKING Ft*tUHt OF 
DATA MANAGEMENT? 

YES 

IF YOU ARE PLANNING TU USE ThE DISPLAY FORMATTING ANy CONTROL 
SOFTWARE wt NEED TU Know SO IT CA . bE INCLUDED In The SYSTEM, 

DO YOU WISH Tu IMCLUOt DISPLAY FUhMaTTInG AMD CUNTRUL SOF1 WARE? 

YES 

01) YOU WISH Tu ACTIVATE THE POWER FAIL RESTART t 
YES 

DOES THIS $YSTE m HA vt ANY COMMUNICATIONS TYPE DEVICES? 

I.t.» VIPS, TTYS, tTC. 

Y£S 

EVERY DEVICE MUST BE ASSIGNED TO A HARDWARE INTERRUPT LEVEL. 
w£ WILL PICK The ABSOLUTE VALUE FuH ALL DEVICES. SlNCb T Ht Y MUST 
(WITH ONE EXCtPTIUNJ BE UNIQUE. LUMMy >ilCAT IONS UEViCES, HUWbVEH. 

MAY SHARE HARDWARE LEVELS ANO THUa TO FACILITATE Tht ASSIGNMENT 
YOU MUST PR>JV IDE A REL A1 1VE LEVEL FU» EACH COMMUNICATION UtVICE 
CONFIGURED. TmE ANSWER TU THE NfeXT QUESTION WILL 

SET UP THE RANGE OF LEVELS YOU wlort TO HAVE. THE ACCEPTABLE VALUES 
ARt! T.2.3.4. IF YUU SPECIFY 1, tH£N ALL COMMUNICATION DtVICCS 
WILL BE ON T Hk SAME WAHOWARE LEVEL. IF YOU SPtCIFY 3, tMtN YOU 
WILL hA VE THE OPPORTUNITY IQ SPREAD ThF COMMUNICATION 0EV1CES 
OVER 3 StKARATfc LEVELS (I, i, 3), WITH THOSE OtVlCES UN LtVtL 
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1 HAVING THfc HIGHEST PRIORITY AND THOSE ON LEVEL 3 THE LOWEST. 
HOW MANY COMMUNICATION PRIORITY LEVELS (1 TO *) DO YOU WJSH? 
ENTER THE NUMBER UP LEVELS. 

« 

ALL COMMUNICATION TYPE DEVICES MU&T BE ATTACHED TO A MULU»LlNt 
COMMUNICATIONS PROCESSOR tMLCP). 

HOW MANY MLCPS Cl TO 10 ) WILL THIS SYSTEM HAVE/ 

A 


WE ARE READY TQ CONFIGURE ANY MLCP CONNECTED ASYNCHRONOUS TERMINAL 
DEVICES lATO) THAT YOU HAyt. THESE INCLOOE THE 7200 HUN jw TELEPRINTER 
MODE AND ALL OTHER ATDS. IF YOU DO NOT HAVE ANT UP THESE UtVICES Ty 
CONPIGURE REPLY "NONE" TO THE POLLUTING OUESTIUN, 

HOW MANY ATUS DO YUU HAVE? 

2 


ATD TERMINAL NUMBER 1 

YOU NEED TO PROVluE THE BUS CHANNEL NumhER TO which IhIS DEVICE 
HAS BEEN ATTACHED, THE CHANNEL NUMBER IS A UWIDUfc POUR CHARACTER 
HEXADECIMAL VALUE WHICH ENOS WITH EJThEH " 00 " OH * 60 *. 

you must enter exactly four characters, 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

F060 

ENTER THE COMMUNICATIONS PRIORITY LEVEL FUR THIS TERMINAL 

2 

DEVICE TYPES SUPPORTED BY THE ASYWCHHfjNUUS Terminal device driver include 
TTY, 7200 , 7801 , 07200 ANO PRU, 

WHAT IS THE DEVICE TYPE FOR THIS ATD DEVICE? 

TTY 

ATD TERMINAL NUMBER 2 
WHAT CHANNEL NUMBER wlLL THIS DEVICE BE ON? 

FCOO 

ENTER THE COMMUNICATIONS PRIORITY LEVEL FOR IMIS Terminal 

3 

WHAT IS THE DEVICE TYPE fuR THIS ATD DEVICE? 

7801 


WE ARE NOW READY TU CONFIGURE THE VIP 77 O 05 OR VIP 7 BW«S WHICH 
ARE TO BE RUN IN VIP 7700 EMULATION mOOE. IF YOU DO N)JT HAVE ANY 
VIPS TO CONFIGURE* HfePLY 'NONE* tU THE POLLUTING QUESTION. 

HOW MANY VIPS DO YUU HAVE? 

3 


VIP TERMINAL NUMBER 1 
WHAT CHANNEL NUMBER «ILL THIS DEVICE Bt ON? 
FFOO 

HQW MANY ViPS ARE POLLED UN THIS CHANNEL? 

0 
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ENTER THE CU««UNIC*UUN3 PRIORITY LEVEL FUR THIS TERMINAL 
i 

IS THIS VtP 4 'CONTROL STATION'? 

yes 

DOES THIS V IP HAVE 4 HUP (RECEIVE ONLY PRINTER) 'f 
YES 

THERE ARE s TYPES uf hup: TTY33. » TY35* TNIQD, TN3VV, ANO TNUUU. 
rtH AT TYPE UP HOP UU YUU HAVE? 

TNiaoo f ■ 

(JOES THU HUP SUPPORT FORM FtfcQ? 

YES 

VIP TERMINAL NUA'HbH i 
hhat CH4NfitL number hill THIS OEViCE BE UN? 

FFflO 

HON MANY VUS Awt PULLEU UN THIS LMANNEL? 

NONE 

ENTfcH THE CUPHUNICATIUhS PRIURITY LEVEL FOR THIS TERMINAL 
5 

IS This VIP A 'CONTROL STaUUN'? 

N 

(JOES THIS VIP HAVt A HUP (RECEIVE UNLY PRlNTEH) t 
<4 

VIP TeWHInal NUMBER 3 
t.MAT CHANNEL NUMBER HILL THIS DEVICE St ON? 

F£00 

HOi«i HAuY VIPS ARE PULLED UN THIS CHANNEL? ; 

1 

E^rTEH THt LDHPUNICATIUNS PRIORITY LEVEL FUR THU TERMINAL 

a 

ENTER THE P'*LL tNb ADDRESS EUR ThU VIP 

12 

DOES THU vIP HAVE A HUP (RECEIVE ONLY PRINTER) f 
NO 


*tf ARE MJU HfeAOY TU CONFIGURE 1 HE H jj 7 0 MUST LINKS HHICH AHt T'J 
HE PUN HY r«E BSC LINE PROTOCOL HANDLER. IF YUU DO NUT HAVE ANY 
*32 70 HOST LINK $ JO COnFIGuRE. HEPLY NONE TU THE FULLUHINto UUESTIUN. 
HOH MAuY H3ri70 MUST LINKS utl YUU NAVE? 

2 

H3270 Llwt NUMBER 1 
AHAT Channel mjmnER mu this LINt 9E IJN? 

? 

YOU NEED Tu PRUVlUE The PUS CHANNEL NUMBER TO HHICP (HIS UtVKE 
HAS RfbN ATTACHED. The CHANNEL NUMBER IS A UNIQUE FUUH CHARACTER 
HEXADECIMAL VALUt hhICh tNOS *ITn EITHER "00** UR "BU", 

YOli MUST F.N IE R EXACTLY FOUR CHARAlT£HS. 
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WMAT CHANNEL NUMBER MILL TH|$ LINE g£ UN? 

F8B0 

ENTER Thk COMMUNICATIONS PRIORITY LEVEL FOR TmIS LINE 

2 

INTER THk PULLING ADDRESS (DECIMAL) FuR This Mi*70 muST LINK 
123 

ENTER THE SELECT ADDRESS (DECIMAL! PUB THIS HS2/V MUST LINK 

23a 

H32T0 LINE NUMBER £ 

WHAT CHANNEL NUMStR MILL THIS LINE. BE ON? 

FBOO 

ENTER Trtt COMMUNICATIONS PRIOR IT Y LEVEL FUR THIS LlNt 

2 

INTER THE PULLING aqoheSS (DECIMALI FOR This m.1270 husT LI** 

12 « 

ENTER THE SELECT ADDRESS (DECIMAL! FOR THIS RAdM) hum LINK 

235 

ME are no# READY mj configure The rolled VIR E-IULAT.JR (RVt! fa#UURS 

(A PVE GRUUR CONSISTS uv ALL THE RV| ST A T Ions A S S t GNE" TO tut SAMt 
HARDWARE Channel)*. IF ruu DO NUT have an? Pvt stations TO CUNHG(i«r » 
REPLY "NONE" 10 Thfe FOLLOWING OUEstlUN. 

NO* MANY Pvt GROUPS DU TUU HAVE? 

2 


PVE GROUP number 1 
ENTER Channel NUMBER FOR PVE GROUP I 
F900 

HQw MANY PVE STATIONS ARE THERE 04 THIS CHANNEL? 

2 

ENTER ThE COMMUNICATIONS PrIUkITY LEVEL FUR THIS t,«UuP 

2 

INTER THE PULLING A00RE5S (0 TO 3l) FuR PV£ STAlIu-* I 

1 

ENTER THE PULLING AUDRESS (0 TU Ji) F(IR PVE SlAIlUN £ 

2 

PVE GROUP NUMBER 2 
ENTER CHANwtL NiJMBtR FUR PvE GROUP £ 

F^SO 

MOW MANY PVE STAT1UNS ARE THiRfe UY THIS CHANNEL? 

3 

ENTER T HE COMMUNICATIONS PRIORITY LEVEL FUR IhU GhuuP 

1 

ENTER THE PULLING ADDRESS (0 To II) FuR PVE STATION » 

1 

ENTER THE POLL INh ADDRESS (0 TU 3U FOR PVE STATIUN « 
2 
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ENTS* THE PULLING 4Q0RESS (0 TU 51) FOR PVE STATION S 
3 


ME ARE NOVI READY fU CONFIGURE THE SYNCHRONOUS TERMINAL DEVICE (STU) 
GROUPS (A STD GRUUP CONSISTS UP AtL ThE STQ STATIONS ASSIGNED TU THE 
SAME hardware Channel.) * tHg POLLING SEUUENCE *ITh1n a group IS 
OETFRMINtU HY the UNDER ENTERED • 

IF YOU OO NOT HAVE ANY STO STATIONS TO CONFIGURE? 

REPLY "NONE" TO THE FOLLOWING QUESTION. 

HON MANY STD GROUPS DU TOU HAVE? 

3 


STU GROUP NUMHEH 1 
ENTER CHANNEL NUMBER FOR STD GROUP I 
F6S0 

ENTER THE CUMFMJNICAtIONS PRIORITY LEVEL FUR THIS GRUUP 

5 

HQvt many siu sr a i Ions are there 0« this channel? 

3 

ENTER THE POLLING AUORESS (0 TO 51) FOR STD STATION 1 

33 

device types supported bt the synchronous terminal uevice driver 

INCLUDE V79'J4, VT TDD AND VTTGO 

WHAT IS ThE DEVICE MPE ►On Tuts »TO OEVtCE? 

V7804 

DOES THIS STO HAVE A hUP (RECEIVE OwLY PhINT tP)? 

YES 

THERE ARE * TYPES UF POP • RQSYga, RoSy^g. TN1QU? AND TNWUU, 

*HAT TYPE UP PUP DU YOU HAVE? 

TN300 

ENTER Trtt PULLING AOURfeSS (0 TU 31) FOR STD STATION i 
3« 

HHAT IS The DEVICE Type FOR THIS STo DEVICE? 

V?90A 

DOES ThIS STO HAVE A PUP (RECblVE ONLY PRINTfcP)? 

r 

what type oh rup uu you have? 

TN500 

STO GRUUP NUM8E* 3 
ENTER CMANwtL FUR StO GROUP i 

FbOO 

ENTER THE CUhmonJCA\(UNS PRIORITY LEVEL FOR IhIS GRUUP 

4 

hOR RANT STU SfATIUNS APE THERE U'V THls CHANNEL? 

3 

ENTER THE PULLING AOUMESS (0 TO 51) FOR STD STATION 5 

33 

WHAT IS The device Type for this ato DEVICE? 


Figure 4-1 (Cont). Using M4_SYSDEF 


4-39 



V770D 

does this std HAvt a rop (receive only printer)/ 

YES 

WHAT TYPE OF POP 00 YOU HAVE? 

TNI200 

ENTER THE POLLING ADDRESS (0 TO 31) FUR STO STATION « 

2« 

HHAT IS THE DEVICE TYPE FOR THIS ST0 OEVICEY 
V7700 

DOES THIS SID HAVE A HOP (RECEIVE ONLY PRINTER)? 

NO 

INTER THE PULLING ADDRESS (0 TO 3U FUR STO STATION 5 

25 

HHAT IS THE DEVICE TYPE FOB THIS STD DEVICE? 

V7700 

POES THIS STD HAVE A NUP (RECEIVE ONLY PRINTER}/ 

YES 

HHAT TYPE OF HOP 1>U YOU HAVE? 

TN1200 


HOP MANY meCP CONNECTED BINARY SY YCHRuNUUS COMMUNICATIONS (BSC) LINES 
DO YOU HAVE/ 

2 


8SC LINE NUMBER I 

HHAT CHANNEL NUMBER HILL THIS DEVICE BE UN? 

F000 

ENTER The COMMUNICATIONS PRIORITY LEVEL FUR THIS Terminal 

1 

IS THIS BSC LINE A 'PRIMARY * ONE? 

YES 

BSC LINE NUMBER 2 

NMAT CHANNEL NUMBER HILL THIS DEVICE bt ON? 

FOSO 

ENTER The CUMMUNICAIlUNS PRIORITY LEVEL FOR lhlS TERMINAL 
l 

IS THIS BSC LINE A »PR(MARY’ ONE? 

NO 


HE ARE NUh READY TO CumFICURE ALL m DC CONNECTED CUNSOLE UEVIt.ES. 
THESE CUNSOLE DEVICES ARE ALL HANULEO BY THE CONSOLE DEVICE 
DRIVER (CON)« IF YOU DO NQT HAVE ANY TU CUNFlGURfc, REPLY 
"NONE" TU THE FQLLUhING QUESTION. 

MOH MANY HOC CONNECTED CUNSOLE DEVICES DU YUU HAVE? 

2 

CON NUMBER t 
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WHAT CHANNEL NUMBER HILL THIS DEVICE BE ON? 

0404 

OEVICE TYPES SUPHUf*TfeO BY THE CUNautE OEVtCE DRIVE* INCLUDE 
KSHj 7200, 7401, 0720U AND P«U. 

WHAT is The DEVICE TYPE FUN THE UMfcRATU^S CONSOLE t 
KSR 

\ 

CON NUMBER 2 

WHAT CHANNEL NUMBER HILL THIS DEVICE 8E ON? 

0440 

WHAT IS THE DEVICE TYPE A OH THIS CUN OEVlCt? 

7801 

WE ARE NUw HEADY TU CONP IGIJME ALL DI SK£ T Tb DEVICES. It 
YOU 00 NOT HAVE ANY OISKETTE UEvIlES# REPLY 'NUNE* TU THE 
FOLLOWING QUESTION. 

HOW MANY DISKETTES OU YQU HAVE? 

4 


diskette number 1 

WHAT CHANNEL NUMBER WILL This OEVICE SE UN? 

0500 

OISKETTE number 2 

WHAT CHANNEL NUMBER WILL THIS DEVICE »E UN? 

0580 

OISKETTE NUMBER S 

WHAT CHANNEL NUMBER WILL THIS DEVICE Hi UN? 

1200 


OISKETTE NUMBER 4 

WHAT CHANNEL NUMBER nILL ThIS DEVICE 8E UN? 
1290 


w£ ARE NOw HEADY TO CONFIGURE ALL CAHlkluGE DISK 
OEVICES• IF YOU UU NUT hAvE ANy Tu CONFIGURE, REPLY 'NUN£' TU The 
FALLOWING UUESTtUN. 

HOW MANY CARTRIDGE DISKS DU YUU HAVE? 

2 


CARTRIDGE DISK NUMBER 1 
WHAT CHANNEL NUMBER WILL THIS DEVICE SE UN? 

1 400 

OUES THIS C*RTRIuGE DISk HAVE A FIXED PLATTER? 
YES 


CARTRIOGE DISK NUMBER 2 
WHAT CHANNEL NUMBER WILL THIS DEVICE RE UN? 
1480 
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DOES THIS CARTRIDGE DISK HAVE A FIXED PLATTER? 

NO 


HE ARE NOR HEADY to CONFIGURE ALL CARTRIDGE MODULE disk 
DEVICES* IF YOU DO NOT HAVE ANY TU CONFIGURE' REPLY 'NUNE' TO THE 
FOLLOWING 8UEST1UN* 

HOR MANY CARTRIDGE MODULE DISKS DU YOU HAVE? 

2 


CARTRIDGE MODULE DISK NUMBER 1 
HHAT CHANNEL NUMBER HILL IHJS DEVICE BE ON? * 

1500 

.CARTRIDGE MODULE DISK NUMBER 2 
HHAT CHANNEL NUMBER RILL THIS DEVICE BE ON? 

1580 

ME ARE NUR READY TU CONFIGURE ALL STORAGE MODULE 
DEVICES. IF YOU DU NUT HAVE ANY !U CONFIGURE' RtPL» 'NONE’ 10 THE 
FOLLORING UUESTIUN, 

HOllE NAnY STORAGE MODULES UU YOU have? 

2 


STORAGE MODULE NUMBER 1 

HHAT CHANNEL NUMHtH RlLL THIS DEVICE BE ON? 

1800 

STORAGE MODULE NUMBER 2 

WHAT CHANNEL NUMBER BILL THIS DEVICE BE ON? 

I860 

HE ARE NOR READY TO CONFIGURE CARO ReAUEH UeVlCbS. IE YOU 
DO NOT HAVE ANY TU CONFIGURE# REPLY '(JUNE* TO THE FULLURlNG BUtSTlON. 
HOR MANY CARD READERS 00 YUU HAVE i 
2 

P 

CARD READER NUMBER 1 
HHAT CHANNEL NUMBER BILL THIS DEVICE BE UN? 

2200 

CARO READER NUMBER 2 
HHAT CHANNEL NUMBER KILL THIS OEViCb BE UN? 

YES 

INVALID CHANNEL NUMBER* MUST BE EXACTLY A CHARACTERS LUNbi 
HHAT CHANNEL NUMBER BILL THJS DEVICE BE UN? 

2260 

HE ARE NOr READY TU CONFIGURE CARD PUNCH AND REAUER/PUNCh DEVICES. 
NOTE THAT THIS IS EITHER A CARD ReADER/PUNCH OR A CARU PUNCH. 
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IF YOU DO NOT HAVE ANY TO CONFIGURE, REPLY , 

"NONE" TO THE POLLUTING QUESTION. 

HQw MANY CANO REAUER/PUnChE 5 UN PUNCHES DU YOU HAVE ? 

NO 

*E ARE nun REAOT TO CONFIGURE ALL PRINTER DEVICES. IF YOU 00 NUT 
HAVE ANY TO CONFIGURE* REPLY 'NONfe* TJ IHfe FOLLOWING UUESTIUN, 

HOW MANY PRINTERS DU TUU HAVE? 

I 

PRINTER NUMBER 1 

WHAT CHANNEL NUMBER mill TmIS DEVICE BE ON? 

1TS0 


WE ARE NOW READY TU CONFIGURE ALL R-TRAC* MAGNETIC t APE DEVICES. 
IF YOU 00 NOT HAVfc ANY TO CONFIGURE* REPLY 'NUNfc* Tu The FOLLOWING 
QUESTION. 

MOW MANY 9-TRACK MAGNETIC TAPE OEYlCtS UU YOU HAVE t 

i 


MAGNETIC TAPE DEVICE NUMBER t 
WHAT CHANNEL NUMBER *ILL THIS OEVUE rtft ON? 
1700 


MAGNEMC TAPE DEVICE NUMBER l 
WHAT CHANNEL numneR WILL This OEViCE RE ON? 
1 ROD 


IF YOU WISH YOU MAY OPTIMIZE ALL FuNCUUNS FOR THE GREATEST 
POSSIBLE SPtEO* But AT TH£ EAPENSt OF HAVING A LARGE HESIUENT SYSTEM. 
DO YOU WISH TO HAVE ALL SYSTEM OVERLAYS RESIDENT? (YES UR NO) 

NO 


BY MAKING PARTICULAR OPERATING SYSTEM InPUT/UuTPuT OVERLAYS PERMANENTLY 
RESIDENT YOU CAN UBT A IN OPTIMUM 3Pt£0 t« SOME CATEGORIES. 

DO YOU WISH TO OPTIMIZE THE «£A01 yg/wRI 11NG OF WEL*Uvk FILES? 

YES 

no YOU WISH TO OPTIMIZE The REAOIyG/wrITING UF RANDOM FILES? 

YES 

on YOU WISH TO OPTIMIZE Tnt READING/WRITING UF INOtXEO FILES? 

YES 

00 YQU WISH TO OPTIMIZE RELATIVE F IlES WITH uELEIASLE HECUHUS? 

YES 

00 YOU WISH TU OPTIMIZE FILE MANAGEMENT UPfcN/CLOSE FUNCTIONS? 

YES 

DO YOU WISH TU optimize The »EAQInG/whI1ING of tape files? 

YES 

00 YQU WISH TO UPfIMIZE EBCDIC TAPt FUNCTIONS? 

YES 
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DO YOU NISH TO CREATE A BATCH MEMORY POOL? 
YES 

HOW BIS A BATCH WOOL? tNNNNN OR NNK WORDS) 

80 * 


ENTER THE NUMBER U TO 99) OF SYSliM OVt«LAY AREAS 
YOU DESIRE. 

6 

WOULD YOU LIRE TU SEE THE SENERATeO STATEMENTS? 

YES 


‘PRODUCED BY INTERACTIVE BUILD (VERSION 8.0), UN INBu/uR/oe tl«V:#e.5 

sys *,seiP,t»,t8,R8#,E 

DEVICE CONOO,O f 5»X'OAOO'.CONSOLE.1*0»»'K5R* 

LDBU CIPSIM 
LDBU SIPSI«„SP 
LDBU IXPFR 

* 'GC036/MQ0 EOO VERSION S.t'f'TCST SJTC UNt' 

RLOCK 

VDAM 

LDBU ZNVDAM 
COMM 9 

ATD it II t A*FD80 , *o 'HI* , 'TTY» 

DEVICE ATp0O»S,H#I e FDflO' 

STTY ATOOO -RECONNECT YES 
ATD 4»SB** > FC00'»''MX*» > Ta<Jt' 

DEVICE *TOOi,tt f i8,i*FC0©' 

STTY ATUOl -RECONNECT YES 

VIP S.ll'XtFEOO'fff'C'tttNWQQ'FU 

DEVICE VIPOO.S.H.X’FFOO’ 

DEVICE RQPOO» 6»11.X *FFOO f 
VIP 7,18.X»FF80N.#*T 
DEVICE VIP01.7,J8,X ( FP«0* 

VIP Sfll'X'FEOO','12 
DEVICE VIP02.8.It* X *►E00 * 

H3870 9eIl»X*FB80**-(iX e 7B*»X*EA* 

device Hiaoo^R.tux'Fseo* 

H3870 IO»U»X*FBUO*»rX'7CSX'EB* 

device Hiaoi.io.iux'Fsoo* 

Pve Ilfll*X*F900'f»t 
device pveoofu»n»*'F9ooe 

PVE U»U.X'F900 ( **2 
DEVICE PVEOlfia.lKX'FVOO' 

PVE i 3«10 ? X'F980 * r t\ 

DEVICE PVE02fIl» t0#X*F980' 

PVE 1«»10,X ( F98O'».8 
DEVICE PVEO3eHMO»x'P980« 

PVE 15»10# X , F 980 ' r» 3 


Figure 4*1 (Cont). Using M4,SYSDEF 
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DEVICE PVE04,15,1Q,X'F980» 
3TDLN 12,X'FM0* 

STD 16,23,,V7»04 

DEVICE 3TD0O, 16,12»X*F680* 

ROP TN300 

DEVICE STDQ1, 16, 12,X*F68Q* 
STO 17,24,,V7804 
DEVICE 3T002,17,12,X'F660* 
ROP TN300 

OEV1CE STU03,17,12,X'k680* 
POLIST 1 
STAPOL 25,2* 

STOLN 15,X'F600' 


STO 16,23,,V7 700 
DEVICE STD04,16,15, 
ROP TNUOO 
DEVICE 67005,16,15, 
STO 19,2«,,V7700 
DEVICE STDOb,19,15, 
STO 20,25,,V7700 
DEVICE $7007,20,15, 
ROP TNI200 
DEVICE $7006,20,15, 
POL 1ST 1 
STAPOL 23,24,25 
DSC 21,10,X * FOOO *,, 
DEVICE BSCOQ,21,10, 
9SC 22,10,X 1 F060 *,, 
DEVICE 6SC01,22, 1<*» 
DEVICE C0N01,23,15, 
DEVICE 03*09,24,16, 
DEVICE 0SK01,25, 17, 
DEVICE 03*02,26,18, 
OEVICE 03*05,27,19, 
• OEVICE RCUOO,1,6, 
OEVICE FCDOO,28,6,X 
OEVICE RC001,29,20, 
OEVICE RCM00,50,21, 
DEVICE FCHOO,51,21, 
OEVICE RCMO1,32,22, 
OEVICE FCMO1,33,22, 
OEVICE HSMOO,34,25, 
OEVICE RSM01,55,24, 
OEVICE CDROO,36,25, 
DEVICE CORO 1,37,26, 
OEVICE LPT00,38,27, 
OEVICE MT90O,39,28, 
DEVICE MT901,«0,29, 
MEMPOOL $,,10000,P 
mEMPQQL 8,,20460,P 


X* F 600 * 
I 'f- 600 * 
*'F600* 
X' F 600 * 
X’FoOO' 


P 

X *F 000' 

s 

F 080 
0480 
0500 
0580 
1200 
1260 
1400 


• 1 * 00 * 
1480 


1500 
1500 
1580 
1580 
1800 
1860 
2200 
2280 
1780 
1 700 
1900 


,,,,*7801' 


Figure 4-1 (Cont). Using M^SYSOEF 
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MEMPOOL *AH,*,PCU 
MEMPOOL »L0,AB 
MEMPOOL »LI * AS 
MEMPQOL »L2»ab 
MEMPOOL .L3.AB 
MEMPQOL »L*. AS 
MEMPQOL »L5»AS 
RE9QLA OTUPX1 
RESOLA OYwRXl 
PE SOLA OTHOM 
RESOLA OYHNXI 
RESOLA OZXINV 
RESOLA OZXSOV 
RESOLA OZXSUH 
RESOLA OVDMNi 
RESOLA QVOMC 
RESOLA OTUPC 
RESOLA OZClttV 
RESOLA UZCKtr 
RESOL* OZCLWt 
RESOLA 0ZCP3N 
RESOLA OZCSUB 
RESOLA OZUCCB 
RESOLA OZUSUb 
RESOLA OYDMT 
RESOLA OZTUTL 
RESOLA OZtET* 
RESOLA UZTATE 
RESOLA QV0MR2 
RESOLA OYUPN 
MAP *SIU»CLM.MAP 
QUIT 


DO YOU nAhT TO CREATE THE CLM DIRECTIVE FILE NUtf? 

YES 

WOULO YOU LlHfc TO USE A PILE NAME UTHgR THAN CLM USER FUR THIS KILL? 
YES 

ENTER YOUR PILE NAME •* 

EXAMPLE A 

CL« FILE NAME IS* 

*SYSSRM»UUO*SYS„AUMlN*SANB0RN*M«Mi.l*ExAMPLE* 

RESTART file NAME IS* 

*SYSSRM»U0U>8YS_AUMIN»SANB0RNRMAMZ,1>M4NST,E 


Figure 4-1 (Cent). Using M4 - SYSDEF 


Example 2* 


To modify the CLM directive file created In Figure 4-1* the user 
Invokes the M4_SYSDEF program in rebuild mode* specifying the name 
of the restart file on the command line. Figure 4—2 Illustrates the 
rebuild mode dialog. 


Yi Ilf HAVE fcMf-wFO -KllSYSnFh IM THE MUOfc , 

OU Yllu *A<ViT TM S*e Twt F.*ISTIM5 CL* ST A 1 Ef-E^TS? 
YES 


♦ PPUPtirgn MV IWTEkiCTIVP MHILI 1 (V£t»siHM ?. 0 ), On 19 * 0 / 09/05 l«<i 7 :«S *3 
sys ,,scIF.e.,F 

nev to. comm*, u,s,«»».cn^snLfi* t '»o,. 'ksb* 

I TM: r TPS t 1 *, 

LPPU STPSI***SP 
I, |1«U /XOC 

* •scuse/f-r.n «n<p vew-Sin*, p.i','pf ppe»ell ki , 1 

v n i m 

Lti*i' /nvPayj* 

O'M 0 

OEMO A Ti.imi, 3, I 1 . Y *F(3flO * 

STfv a Tofu. . -Pl-ClWtCl tKS 
4 TO a, IP, Y’t-con*,,'*i •, ’ 7 «*<>i * 
nEVrCF4TTii1,«,1p 1 I'FC< 1 «i' 

STTY ATttfll -tvFCd'^FCr YES 

v [p 

OEVJO V TPf‘0, 5, 11 , x 'FFOti' 

'lEYICt POPifu, a. II , t 'FfrtO ' 

V TP 7, 1p, *'FFHrt ' , , , , r 
'lEvTCtvTfc'l»1,/,l?,X'FF*0' 

VJP ft, 1 1 , t 'Ff(rft ' , , 1 p ’ 

"Evict vtpmp,«. n , v 'f-Frtn* 

*S?70 9, 1 1 ,X*MftO* , ,X '7^ ' ,X ' (■ A ' 

"EV io H <PfM», 9, 11 , * ' Fftftl> ' 

H <?7 0 1 II,11,X'F*Or>',,J<</C',**(;*' 

(l£VtCF f3Pf't , t rt, 1 t , * 

»VF I 1 , 1 1 . Y 'MOrt' , , 1 

!>evict- eve mo, 11 , u, % • f«ho * 

PVF 1 ?, t 1 , k * F **en * , , P ■ 

"FV TO. PVM't , 11 » * 'F<*<>9 * 


Figure 4-2. Using M4_SYSDEF In Rebuild Mode 
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PVF 13,10,X'FM*0»,,1 
DEVICE PVE02,t3,10,x'F9e0' 

PVE ia,10,X'F980*,,2 
DEVICE PVE03 r ia t to,X'hQhO* 

PVE 15,!0.X'F9*O*,,3 
DEVICE Pveo«,S5,10,*'F9*fl' 

8TDLN 12,X'F*H0< 

STD 16,23,,V7M0« 

DEVICE STi)O0,lb,1?,i'F*»a0' 

WfJP TMOO 

DEVICE STDOJ ( 16,IP,*'F6*0 * 

5 TR I 7,24,,V7(J«a 

DEVICE $T1)02,1?,12,x*F*aO' 

RQP Tf-MOO 

DEVICE 5T00J,17,1?,*»Ffc8n' 

PUUtST t 
STftPflu 2*,?a 
SIDLN O.X'FMiO' 

STD 1A,25»,V770O 

DEVICE STROP, 1*, 1 3, X 'F600' 

POP T.v12n0 

DEVICE S7D•*S, l*, 1 3, « *Pfc».0* 

STD io,2a,,v7/oo 

DEVICE STDOh, IP,) *,* , E6(»»(* 

STD ?0,23,,V770fl 

DEVICE STDOT,?fl, 1 $, X 'F«,oO' 

R(JP TM?00 

DEVICE ST006,2n,l3,*'F6l»0* 

PHI 1ST t 
STAPOl 23,2a, 2 S 
DSC 21,10,X'Egft.I',,P 
DEVICE 8SC0A,21,14,x'PDott* 

8SC 22,10,x , F4*0',,S 
DEVICE ssc«l, 22 , 10 ,« , F < >aO* 

DEVICE CDwOl .23, IS, * »Oaaf,», , 'TAtiJ ' 

device na*rto,2a,i6,x'i»si'0' 

DEVICE 0S801,2S,17,« 

DEVICE OSRtl2,2S,»8,RM^oO , 

DEVICE D*«05,2T,l*,x'lP*tfl* 

* DEVICE PCDOO, 1,6.X 1 1400* 

DEVICE FC0 n 0»2S,P,»*1 art*' 

DEVICE »CDWl,2P,?0,x'l**0* 

DEVICE PCMOO,30,PI,X 1 1 SOO' 

DEVICE ECM00,31,21,X*1S00* 

DEVICE RCP01,33,22,XMSAO' 

DEVICE FCMOl, 33,22,xMSSO* 

DEVICE *5*100,36,23,X'lSOO' 

DEVICE «Srt01,3S,24,X'lSSft' 

DEVICE Cft«00,36,?5,x'2?00' 

DEVICE CDROt,37,26,X 1 22SO* 


Figure 4-2 (Cont). Using M4_SYSDEF In Rebuild Mode 
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device 

OeviCC NT900,3R,a8,XM700' 

DEVICE MT901,a0.a9,X'i900' 

MfiMPOOL 3.,10000,P „ 

MEMPOOt 8,,204*0,P 
M6MP00U »AR,*,PCU 
MfiMPOOL ,L0,A8 
MEMPOOt ,L1,*8 
MgMPOOU ,L2,*8 
MEHPOOL ,L3»*9 
MEMPOOt ,L«*A8 
MEMPOOt »l 5,AB 
RESOLA OtuPXl 
RESOL* OVhRXt 
RESOL* OYROX1 
RESOLA OYRMXt 
RESOL* 07XINV 
RESOLA OZXSQV 
RESOLA OZXSU« 

RESOLA 0V0MR3 
RESOt* OTOmc 
RESO t* OVUPC 
RESOt* OZCINV 
RESOLA. OZCKEY 
RESOLA 07CLNK 
RESOLA 07CPSN 
RESOLA OZCSUR 
RESOLA OZilCCR 
RESOLA OZuSUP 
RESOLA QYOMT 
RESOLA OZTUTL 
RESOLA OZTETA 
RESOLA OZTATE 
RESOLA 0Y0MR2 
RESOLA OYQPN 
map >sio>clm!map 
oun 

00 YOU MlSH TO MOOTRY DEVICES OR SYSTEM PARAMETERS? 

RESPONO WITH "SYSTEM*, "DEVICES", "VIEW", OR "OUNfe*. 

RESPONSE * 

DEVICES 

RESPONO rttTH THE OEVtCE TYPE OR CLASS THAT YOU «tSH T-0 MOOIPY. 
"COMM", "CON", "OSK", "RCO"» "MSM", "CMO", "COR", 

"CRP", "LPT", "MTP", 0« "OONE". 

RESPONSE * 

COMM 

00 YOU KISH TO MOOIPY ThC COMMUNICATIONS LEVELS AND THE NUMBER OP 

MLCP'S (COMM), THE VIP'S (VIP), T*E MOST LINKS (M3270), THE 
PVES (PVE), THE SYNCHRONOUS TERMINALS (STQ), 

THE ASYNCHRONOUS TERMINALS (ATO). OR the BSC'S (SBC)? 

RESPONSE • 

COMM- 


ri-jure 4-2 (Cant). Using M4_$YSQ£? In Rebuild Mode 
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DOES THIS SYSTEM HAVE ANY COMMUNICATIONS TYPE DEVICES? 

I.E.# VIPS# TTYS# ETC, 

NO 

DO YOU NISH TO MOUTFY THE COMMUNICATIONS LEVELS AND THE NUMBER OF 
MUR'S (COMM) , THE VIP'S (VIP) , THE HOST LINKS (H3870), THE 
PVES (PVE)# THE SYNCHRONOUS TERMINALS (STD)# 

THE ASYNCHRONOUS TERMINALS CATO)# OR THE BSC'S (BSC)? 

RESPONSE s 
DONE 

RESPOND «ITh THE DEVICE TTPE 0» CLASS THAT YOU WISH TO MODIFY, 
"COMM", *cnf!«, *D$K", "PCD" # "MSM", "CMO"# "COR"# 

"CRP"# "LPT", "MTP", UR "DONE". 

RESPONSE * 

DONE 

DO YOU WISH TO MOOTFY DEVICES ON SYSTEM PARAMETERS? 

RESPOND WITH "SYSTEM", "DEVICES", "VIEW", OH "DONE". 

RESPONSE * 

SYSTEM 

DO YOU WISH TO MOOTFY TnE PROMPT (PROMPT), MEMORY SIZE (MEMORY)# THE 
NUMBER OF INTERACTTvE USERS (USERS), The AUTOMATIC GENERATION OF 
SPD NAMES (SPO),Tm| AUTOMATIC ChAnNEL ASSIGNMENT (CHANNEL)# THE 
RECORD LOCKING FEATURE (RLOCK), The SYSTEM OVERLAY AREAS (SOAT)# THE 
RESIDENT OVIRLATS (RCSOL*)# ThE DISPLAY FORMATING FEATURE (VOAM), 

THE COMMERCIAL OR SIP SIMULATORS (SIMUL)# 

OR THE SYSTE M ANO TNSTAlLATION IDENTIFICATION (JDENT)? 

RESPONSE * 

RCSOL A 


IF YOU WISH YOU MAY OPTIMIZE ALL FUNCTIONS FOR THE GREATEST 
POSSIBLE SPEFO, «UT AT THE ftPENSt OF HAVING A LARGE RESIDENT SYSTEM, 
DO YOU WISH TO HAVE ALL SYSTEM OVERLAYS RESIDENT? (YES OR NO) 

YES 

DO YOU WISH TO MODIFY ThE PROMPT (PROMPT), mEMORT SIZE (MEMORY), THE 
NUMBER OF INTERACTIVE USERS (USERS), THE AUTOMATIC GENERATION OF 
SPD NAMES (SPO),Th£ AUTOMATIC CHANNEL ASSIGNMENT (CHANNEL), THE 
RECORD LOCKING FEATURE (RLOCK), Th£ SYSTEM OVERLAY AREAS (SOAT), THE 
RESIDENT OVERLAYS (USOlA), Tm£ DISPLAY FORMATING FEATURE (VOAM), 

THE COMMERCIAL OR SIP SIMULATORS (S)MUL), 

OR THE SYSTE“ AND INSTALLATION IDENT IF ICA UUN (IUENT)? 

RESPONSE • 

DONE 

DO YOU WISH TO MODIFY DEVICES OR SYSTEM PARAMETERS? 

RESPOND WITH "SYSTEM", "DEVICES", ."VIEW", OR "OON£". 

RESPONSE * , 

DONE 

WOULD YOU LIKE TO SEE ThE GENERATED STATEMENTS? 

YES 


Figure 4-2 (Cont). Using M4_$YSD£F In Rebuild Mode 





•produced interactive f*milD (vtRsttiN n« 

SrS ,.scip.h,ir.rh, ,e 

device cn:joo,o, 5 . **n«oo • .cnu.soLfc, i ao,,' ksh* 

LOflU CIP5IM. 

LD6U ST?SIM_$P 
LOHU ZXPFR 

* •GCttSfc/MOO OOO VERSION 2.1','PEPPERtLL PA.' 


«LOC* 

VOAM 

LOPU ZNVDAM 


oevice 

C0N0I,23,15.x 

*0960 

OEVICE 

DSK00.4R.16.X 

* (iRqO 

OEVtCF 

OSAOU24.17.X 

' 05*0 

OEVICE 

DS602.26,|8.X 

' 1200 

OEVICE 

USK03.27, 19.X 

*1260 

* DEVICE RCOOy.1,6.X 

* 1 900 

DEVICE 

PCOOO.aP.S.X'laOft' 

DEVICE 

RCiini .29. ?o. x 

* 196') 

DEVICE 

RCMflO.3«.2t,X 

'1500 

DEVICE 

FCM00.3T.P1.X 

*1500 

DEVICE 

RCM01.52.P2.X 

' 15*0 

DEVICE 

FCM01.3S.23.X 

' (560 

DEVICE 

MSMOO.3«.*3. x 

' t*oo 

DEVICE 

MRmO 1.35.29. x 

'1*40 

DEVICE 

COROO.36,35.x 

'2200 

DEVICE 

CORO 1,37.26.x 

' 2260 

DEVICE 

LPT00.3S.27.X 

'1760 

DEVICE 

MT9O0.39.26,* 

' 17 0 0 

DEVICE 

MT901.90,29.X 

' 1 900 

HEMPO0L 

s.,inooo.p 


MEMPQOL 

fl».20960,P 


MEMPOOL 

. Ap.*,PC0 


MEMPOOL 

,L«.AH 


MEPPOOL 

,L1.Ae 


MEMPnuL 

»L2,AH 


4EMPOOL 

.L3,AS 


MfiMPOOL 

.L«,*6 


PEMPOOL 

,U5.AH 


CLMIM rerola 


MAP »ST0>CL m "mAP 


outr 




W60/Q9/0b 58.3 


00 rnu *6NT TO C«FATE r*E CL" DIRECTIVE FRt N(l*? 

YES 

1TOULO rou LIKE rn USE A PILE mAmF OTHER THAN CL*_U3E« FOR THIS FILE? 
TgS 

ENTER YOUR FILP NAMfe • • 
gXAMPLFT* 

CLP PILE NA*'E TSS 

*svssRM»uon>srs.AO'it l \i>sALHi)Wh*ontH>tJi APPi et74 
RESTART PILE NAMF tr: 

*SYSSRP»u0f>»SrS_A0Mrfo>s4»;*MPn>ons«»MaRST 


figure 4-2VCont), Using M4_SYS0EF In Rebuild Mode 
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SECTION V 


BASIC CLM DIRECTIVES 


This section describes the CLM directives used to define the basic 
characteristics of the system.. The CLM directives for the optional 
communications environment of the system are described in Section 
VI. If you are a first-time user* you should be thoroughly familiar 
with all the tooics discussed at the beginning of this section 
before you create your CLM directive file. 

Appropriately coded CLM directives (including those for 
communications* if aoplicable) must be placed in the CLM_USER file 
under directory SID on the bootstrap volume before a stage 2 or 
stage 3 system startup is performed. (The stages of system startup 
are described. (The stages of system startup are described in 
Section III). 

Table 5-1 summarizes the basic CLM directives* which are described 
in alphaoetic order later in this section. Briefly* these CLM 
directives define the following aspects of the system* 

. System variables such as oower line frequency* scan cycle of 
real-time clock* Scientific and/or Commercial Instruction 
Processor options, number of system overlay areas, number of 
trap save areas, number of intermediate request blocks, and 
eroanded error message code option (SYS directive). 

• Characteristics and sizes of system memory pool, online memory 
pools, and batch memory pool (if any) (MEMPOOL directives). 

. Physical and logical characteristics of MDC-connected 
peripheral devices (DEVICE directives). 

. System overlays that are to be made permanently resident 
(RESOLD directives). 

. derating system extensions that are to be made permanently 
resident (LDBd directives). 

. System physical attributes* system structures, device status* 
user-defined variables, and memory pool soeclficatlons (MAP 
iiracttve). 


Single character expressions that may be used in certain 
directives instead of constant values (VARIABLE directives) 




CLMIN Causes subsequent CLM directives to be read from a 

different device/file. 

★ (Comment) Used to include a comment in the file of CLM 
directives. 

DEVICE Identifies a peripheral device and its 

characteristicst both physical and logical. 

DRIVER Identifies a user-written device driver and one 

device driven by it. 

LD3U Identifies a bound unit (usually user-written) that 

is to be made permanently resident in the system area 
of memory. 

MAP Provides configuration information that allows you to 

verify the success of certain aspects of the system 
building process. 

MEMPOOL Defines the system memory pool, the batch memory • ■ 

pool, or one or more online memory pools. 

QUIT Indicates the end of the input file of CLM ■ • 

directives. 

RH30LA Identifies one or more system overlays that are to be 

made permanently resident in the system area of 
memory. 

BLOCK Defines a pool of structures to be used by data 

management when record locking is requested. 

SYS Defines a number of system variables, 

VARIABLE Allows you to define variables for parameters In 
certain CLM directive statements. 
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RULES FOR ARRANGING CLM DIRECTIVES 


Only a few rules aoply to the order of basic directives in the input 
file read by the Configuration Load Manager. These rules are listed 
below. (Rules governing the order of communlcations-related CLM 
directives are described near the beginning of Section VI). 

1. Each communications (MDC-connected) peripheral device in the 
system must be identified In a separate DEVICE directive. (As 
described in Section VI* communications devices must be 
identified in DEVICE directives only if they are to be 
accessible through the file system). 

2. If the operator terminal Is connected to an MDC, the DEVICE 
directive for the operator terminal should be the first CLM 
directive! This arrangement allows the operator terminal to be 
available for possible error messages related to subsequent 
CLM directi ves. 

3. If your configuration requires more than the default number of 
trap save areas (7) and/or more than the default number of 
intermediate request blocks (20), a SYS directive with 
appropriate tsa and irb argument values should be placed as 
close as possible to the beginning of the file of CLM 
directives. The addtional trap save areas and/or intermediate 
request blocks are available as soon as the SYS directive is 
read. 

4. If the CLMIN directive is used, it must not precede the DEVICE 
directive that identifies the device implied by the pathname 
argument of the CLMIN directive. 

5. If LD3U directives are used to Identify both a SIP Simulator 
and a Commercial Simulator, the simulator identified in the 
latter LDBU directive will be the first to process a trap to 
the trap vector shared by the two simulators. 

6 . A variable must be defined by a VARIABLE directive in the CLM 
file before it can be used in subsequent directives. 

7. QUIT must be the last CLM directive in the input file. Any 
directives that follow QUIT wli not be processed. 


rORMAT OF CLM PI RECTI VES 


A CLM directive consists of a string of up to 72 ASCII characters. 
The format of a CLM directive is shown below* 

mnemonic argument..!!,argument_2]I,argument_3]...C,argument_n] 

In the directive descriptions In this section and in Section VI, the 
following conventions apply* 
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1. The directive mnemonic is shown in uppercase* It must be 

specified exact!/ as shown. » 

2. Exactly one space must separate the directive mnemonic from 
the first argument. 

3. In arguments, lowercase words and letters Indicate values that 
must be specified by the user, 

4. Arguments within square brackets £J are optional. 

5. Vertically stacked arguments within braces O represent 
options, one of which must be chosen when the argument is 
used. 

6. Arguments In a directive are separated by commas. Embedded 
blanks are not allowed within arguments. Blanks are not 
allowed between arguments. 

7. A blank terminates the list of arguments in a directive. 
Anything following this blank is considered a comment. 

3. All arguments are positional, meaning that they must be 

specified in the order shown in the directive description. If 
a given argument is omitted and a following argument is used, 
the omitted argument must be signified by delimiting commas 
Ce.g., DEVICE LPT02,!5,22, X' 1380',, ,N) . 

9. Trailing commas are not required after the last argument. 

10. Continuation lines are not allowed. 

11. Unless stated otherwise, unsigned positive Integers less than 
or equal to 65,535 (10) (FFFF (16)) can be expressed In 
decimal or hexadecimal. 

If a value exceeds 65,535 (10), It must be expressed In 
double-word hexadecimal format (i.e., D'hhhhhhhh'). 

A decimal integer consists of one or more decimal digits 
(e.g., 12 34). 

A hexadecimal channel number consists of the constant "X“ 
followed by four hexadecimal digits exoressed in the format* 
X'h...' (e.g., X'FFSO')* 

12. If an ASCII character string beg1 ns with a decimal digit, the 
string must be enclosed within apostrophes (e.g., 'IA'). 

' 13. The line length specified for a terminal or other input device 
at system building time overrides the command processor line 
length of 127 characters. For example* at a terminal 
configured with a line length of 80 characters, you cannot 
enter a continuous command line longer than 80 characters 
unless you type an amoersant (4) at the end of the line and 
then continue on one or more additional lines. You can alter 
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the terminal/s line length by using the set terminal 
characteristics (STTY) command (described in the Commands 
manual) after system initialization or by modifying the STTY 
directive in your CLM file. 


14, For each noncommunications device configured, you have the 
option of specifying a channel number or allowing the system 
to dynamically assign or Afloat*' channel assignments at 
startup time (I), To float a channel, you specify the channel 
number parameter in the appropriate DEVICE or DRIVER directive 
with a single zero (0). The system then assigns appropriate 
devices to any available channels. Note that if you specify a 
zero channel and the system cannot locate an appropriate 
device for it, no error message is issued. 


M4_.SYSDEF, the interactive CLM directive generation program, allows 
you to float channel numbers for all noncommunications devices, if 
you so choose. See Section IV for details. 


Channel numbers are assigned according to the order in which DEVICE 
or DRIVER directives with zero (0) channels are specified in the CLM 
file. To prevent devices with zero channels from inadvertently 
preempting devices whose channel numbers are explicitly specified, 
all devices of a given type with explicitly specified channel 
numbers should precede all devices of that type with zero channels 
in the CLM file. 

For noncommunications devices, the first available device having the 
lowest bus address and the correct device identification is assigned 
to the first available MDC-connected DEVICE or DRIVER directive 
encountered in the CLM file, and so on. 

If a system is configured with devices containing zero channel 
numbers, you may determine all channel numbers assigned by the 
system after system initialization. The system operator can issue 
the command STS -ALL to list each device and its channel number 
a ssignment. 

Specifying a DEVICE KSR directive with a zero channel number causes 
the system to search for the first available MDC-connected 
keyboard/tyoewriter terminal. If none is available, the system will 
assign an MDC-connected CRT/kewboard terminal to the KSR driver. 

Note that the KSR driver is caoable of operating only in command 
mode and single character mode*• 

Specifying a DEVICE CON directive with a zero channel number causes 
the system to search for the first available MDC-connected 
CRT/keyboard terminal. If none Is available, the system assigns an 
MDC-connected keyboard/typewriter terminal to the CON driver, but 

(1 i 

8y assigning floating channel numbers to devices in the CLM file, 
the system builder need not know the channel numbers at each 
installation that will receive a copy of the system software. 
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only If the "terminal-type" parameter (the eighth parameter in the 
DEVICE directive) is specified as fCSR or TTY. Note that the CON 
driver operates in field and command modes only. 

The system identifies the oresence of a device adapter and assumes 
that the corresponding channel numbers are valid and usable. In such 
a case, the system may associate an unusable channel with a physical 
device. If no device is available to satisfy the directive, the 
user is not informed. If a system included device adapters but not 
associated devices, then explicit channel numbers should be assigned 
to all devices within the device class. 


PRELIMINARY CONSIDERATIONS 


The following paragraphs describe* 

. How to incorporate overlays and user-written bound units into 
your configuration. 

. Memory allocation and usage. 

. Performance considerations. 

. How to identify your oeripheral devices. 

. How to configure the operator terminal. 

. rile system pathnames in CLM directives. 

You should review each of tnese topics before you create your CLM 
directive file. 


System Overlays 


Within the system software, many system functions are implemented as 
overlays. Each system overlay runs in a 512-word system overlay area 
in the system area of memory. By default, one 512-word system 
overlay area is created. If you wish, you may use the olan argument 
of the SYS directive to create additional 512-word system overlay 
areas (up to maximum of 99) so that multiple system overlays can be 
co-resident at any time. In this case, the system will not be 
forced to repeatedly change the contents of the single system 
overlay area as various system overlay functions are required. 

In addition to, or Instead of creating multiple system overlay 
areas, you may wish to make certain frequently used system overlays 
permanently resident In the system area of memory (increassing its 
size at the expense of memory available for user tasks)! This can be 
done by means of the RESOLA directive. Each RESOLA directive allows 
specification of one or more system overlays, each of which is 
loaded for permanent residency during system startup. The names and 
aoproximate sizes of all system overlays are listed in Appendix B. 





System Extensions 


A system extension is an optional, user-written or system-supplied 
bound unit (consisting of re-entrant code) that is identified in an 
LDBJ directive and loaded, for permanent residency in the system 
area of memory, during system configuration (1). Multiple system 
extensions can be used. 

System extensions are most efficient when they are more or less 
continuously used through symbolic references from multiple 
application task groups and this usage does not permit a possible 
delay in the initial loading of the extension. 

System extensions may be used to define system-wide global address 
symbols. These symbols must have been defined in EDEr Linker 
directives as each extension bound unit was linked. Later, as the 
bound unit is loaded during system configuration (by virtue of the 
LDBU directive) , the system-wide global address symbols are added to 
the system symbol table, where they can be used (by the system 
loader) to resolve any unresolved references to them occurring in 
subsequently loaded bound units. 

Any dynamic requests for memory originating from a permanently 
resident system extension are fulfilled from the memory pool of the 
task group that is using the extension. 

Note that if system extension code is not concurrently used by 
multiple applications, it can be individually linked into aoplicable 
user-written bound units and not loaded for permanent residency at 
system startup. In this case, an JDBU directive is not used, and 
the extension will reside in memory only as part of each 
user-written bound unit with which it has been linked. Appropriate 
symbols in system extensions used in this way can be identified in 
XDEF Assembler control statements and thus resolved at link time. 


Memory Allocation and Usage 


System startup allows main memory to be divided into the following 
areas (as a maximum)* 

. System area ? 

. System memory pool 
. Online memory pools 

- Exclusive 

- Nonexclusive 

. Batch memory pool 


( I) 

The SYS Linker directive must be used when the system extension is 
linked. 
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The system area contains resident system software, one or more 
system overlay areas (as specified by the olan argument of die SYS 
directive), any permanently resident system extensions (as specified 
in LD3U directives), and any user-written device drivers (as 
specified in DRIVER directives). The system memory pool, online 
memory pools, and batch memory pool are described in separate 
MEMP(X)L directives (the batch memory pool is optional). Each 
MEMPtXJL directive establishes the type and size of one or more 
memory pools. In the case of online memory pools, the MEMPOLL 
directive also establishes (I) the 2-character identity of each 
memory pool defined therein and (2) whether, for each memory pool 
defined, additional memory can be obtained, as necessary, from the 
batch memory pool (if any). 

Roots of bound units linked as sharable are loaded into the system 
memory pool, whereas roots of bound units linked as non-sharable are 
loaded into an online memory pool or into the batch memory pool. 

Each task group is associated with one and only one memory pool, but 
more than one task group may be associated with the same memory 
pool. See the System Comcepts manual for a more detailed description 
of memory pools. 


ACCESS Tt) MEMORY POOLS 


following a system startup, all nondisk devices and files are 
initially accessible to task groups in online memory pools and In 
the batch memory pool (if any). The MFA (modify file) command can be 
used (In an online memory pool task group) to make a nondisk device 
or file inaccessible to the batch memory pool. However, when a 
subsequent system startup Is performed, ail nondisk devices and 
flies are once again accessible to task groups In online memory 
pools and In the batch memory pool (if any). 


FRAGMENTATI ON 


One memory—re lated phenomenon, "fragmentation," warrants mention 
here. Fragmentation is the development, within a memory pool, of 
unusable "holes" or "fragments" of memory. It usually results from 
the dynamic acquisition and release of memory within a oool by a 
number of concurrently active tasks* Since the system-'s memory 
manager satisfies dynamic requests for memory within a pool on a 
first-come/first-served basis in consecutive multiples of 32-word 
blocks, it is possible that the order of memory acquisition and 
release may create a situation wherein a request for memory cannot 
be satisfied even though sufficient free memory exists. 

This situation might occur, for example, when a task has 
successfully obtained four areas of memory within a oool and the 
pool's free memory is nearly exhausted. If the task released the 
second area (e.g., 128 words) and the fourth area (e.g., 96 words). 


the task's subsequent request for >92 words might be unsuccessful 
because that much consecutive memory Is not available (even though 
at least 224 words — the amount released — is available in two 
nonconsecutlve areas). 

Note that if tasks obtain and release memory on a 
last-obtained/first-reiease basis, the potential for fragmentation 
is reduced, especially when only a few tasks share a particular 
memory poll. 

The potential for fragmentation Increases with the number of tasks 
sharing a memory pool and with these tasks's dynamic use of memory. 
In general, the sytem memory pool becomes fragmented before user 
memory pools do. Calculations for memory pool size later in this 
section include a factor to allow for potential fragmentation. 


Performance Considerations 

. Systems can be configured on hardware having an MMU without 
utilizing the MMU. Ihi3 is accomolished by use of CLM MEMP(X)L 
directives. If no memory pools are protected or contained, and 
no batch pool exists (or an existing batch pool is specified as 
not contained), then the features of the MMU cannot be used. 

. In a given configuration, if any single nonexclusive pool has 
protect and/or contain attributes, all nonexclusive pools have 
the same attributes. 

. MMU Inrush Overhead 

MMU inrush is defined as the load of MMU by firmware at context 
restore time. 

- If pools other than the system pool are protected and/or if 
pools other than the batch pool are contained, there will be 
an MMU inrush each time any task except a system task is 
scheduled. On a system with an WMU, the inrush will take >9 
microseconds for SAr and 37 microseconds for LAF. 

- If only the system pool is protected and/or only the batch 
pool is contained, there is no MMU inrush overhead. A single 
load of the MMU occurs during system initialization and the 
MMU contents are not changed unless the system is 
reconfigured. (The only exception is that the MMU contents 
are temporarily changed at batch rollout). 

- If the system is configured without orotection or 
containment, there is no inrush overhead. 

- For configurations in which MMU inrushes occur, a data 
structure of 32 words for SAF (64 words for LAF) is required 
for each protected or contained pool and for the set of 
nonprotected noncontained pools. 


I 
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Identifying Peripheral Devices 

Each communications (MDC-conneeted) oeripheral device In the system 
must be Identified In a separate DEVICE directive*, The device may be 
designated as accessible through the file system or accessible only 
through physical input/output* (As described in Section VI, 
communications devices must be identified In DEVICE directives only 
if they are to be accessible through the file system). 

The DEVICE directive's arguments, specify the characteristics of the 
device * 

. Unique device unit identifier 

« Priority level number 

. Channel number on Mega bus 

. Unique logical resource number 

. Unique device name for file system references 

. Maximum record size 

» 3uffered/unbuffered input/output 


Configuring the Operator Terminal 

The following paragraphs describe characteristics of the. operator 
terminal and the various configuration options available to you. 


OPERATOR TERMINAL CHARACTERISTICS 


The operator terminal is the single device designated as the control 
terminal for the system. It must be assigned to Irn 0 at system 
configuration time in order to be identified by the system. 

The operator terminal Is the only terminal from which communication 
with the system task group $S is possible. Capabilities unique to 
the operator terminal include the creation of the batch task group, 
suspension and reactivation of batch and online task groups, 
peripheral device control, print/punch daemon startup, and the 
monitoring of system status. 

Normally, an operator terminal Is configured during a stage 2 or 
stage 3 system startup. (An operator terminal is always configured 
automatically in a stage I system startup). The operator terminal 
may be a terminal connected to an MLCP/DLCP. 


CONFIGURATION OPTIONS 


As the system builder, you have three options with respect to 
configuring the operator terminal* 
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. You cart configure a terminal that will function as the.opera tor 
terminal for the life of the system. 

. You can configure a dual-purpose terminal that can funtion 
alternately as an operator terminal and as a non operator 
terminal. 

. You can choose not to.configure an operator terminal. 

You might choose the first option If you wish to always have one 
terminal reserved for the operator's exclusive use'. This terminal 
would always have the capability to perform those control and 
administrative functions unique to the operator. Note that the 
operator terminal cannot support forms processing software. 

The second configuration.option allows you to assign a dual function 
and identify to the operator terminal. You assign two unique names 
to the terminal* a "device name" that Identifies the terminal when 
it is functioning as a non-operator terminal, and an "operator 
terminal name" that identifies the terminal when it is functioning 
as an operator terminal. You might choose this configuration option 
if operator functions will be infrequently performed and you wish to 
free the operator terminal for user applications (especially forms 
processing). The ability to perform forms processing will only be 
available to users when the terminal is functioning as a 
non-opera tor terminal. 

operating procedures for an operator's console configured by one of 
the above methods are fully described in the operator's Guide. 

The third configuration,option does not permit commands and 
procedures unique to the operator terminal to be performed. You 
might choose this option if your system configuration will run under 
a dedicated aopllcation. 

Configuring an Operator. Terminal to runction for the Life of the 
system. 

A device configured to function as the operator terminal for the 
life of the system will always allow users the capability to perform 
those control and administrative functions unique to the operator. 

If the permanently assigned operator terminal is connected to an 
MDC* the operator terminal must be identified by a DEVICE directive. 
This DEVICE directive should be first in the CLM directive file so 
that the operator terminal is a vailable to receive any error message 
that relates to subsequent CLM directives. 

If the permanently assigned operator terminal is connected to an 
MLCP/DLCP, both a DEVICE directive and an appropriate communication 
directive (a.g. f AID) are required. CA COMM directive is also 
required). An MLCP/DLCP-connectad operator terminal is activated 
only after system startup is complete. 


I 


5-11 



In either case* the logical resource number on the DEVICE directive 
must be explicitly specified as 0. Any appropriate level number and 
channel number may be specified* The record size argument should 
normally be set at 140 bytes (characters)* Note that the specified 
record size affects only the file system's use of the operator 
terminal* regardless of the value of record_size, the Operator 
Interface Manager always uses 140 characters as the maximum for its 
control of input and output operations to the operator terminal* The 
device name of the operator terminal may be any user-seleeted name 
(customarily, CONSOLE is used)* 

Example 1 * 

DEVICE CONGO, 0,8, X''0500' ,CONSOLE, MO ,N ,•'7200*' 

In this example, the operator terminal is conencted to an MDC* The 

device unit name is CONGO. The logical resource number is 0 (a 

requirement for the operator terminal). The priority level is 8. The 
channel number is 0500. The device name is CONSOLE! The record size 
for file system access is 140 bytes. I/O to the device will be 
unbuffered. The terminal is a VIP7200. The default for visual 
display mode, 'T', has been accepted. 

Example 2* 

Comm 9 

DEVICE TTY00,0,J1,X'FF80',CONSOLE,140 
TTY 0,11,X'FF80' 

In tnis example, the ooerator terminal is connected to an MLCP. The 

device unit name is TTYOO. The logical resource number is 0 (a 

requirement for the operator terminal)! The priority level is It. 

The channel number Is FF80« The device name is CONSOLE. The record 
size for file system access is 140 bytes. In the COMM directive, 9 
Is the priority level at which the MLCP will interrupt the central 
processor* In the TTY directive, default values hava been accented 
for modem type and line speed. 


Configuring a Dual-Purpose Operator Terminal 

You have the option to donfigure a dual-purpose operator terminal. A 
dual—purpose terminal can function alternatively as an operator 
terminal and as a non-operator terminal. Only one device in your 
configuration may be configured in this manner. Users control in 
which capacity the terminal functions (as an operator terminal or 
non-operator terminal) by means of the OPEB command described later 
in this section. 

If the device that will function alternatively as an operator 
terminal and a non-operator terminal is connected to an MDC, the 
device must be identified by a DEVICE directive with the first 
parameter as CONnn! This DEVICE directive should be the first in the 
file of CLM directives so that the terminal is available to receive 
any error message that relates to subsequent CLM directives. 
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For an MDC-connected device, the directive is of the form* 

DEVICE CONnn,lrn,level,X'channel',device.name, record.size, 

N,terminal.type, mi ,operator.terminal.name 

If the device is connected to an MLCP/DLCP, both a DEVICE directive 
3nd an'ATD directive are required. (A COMM directive is also 
required). An MLCP/DLCP-connected opera tor/non-operator terminal is 
activated only after system startup is complete. It is recommended 
that the terminal not be a dialed line. 

For an MLCP-cannected device, the 'ATD and DEVICE directives are of 
the form* f 

DEVICE 'ATDnn,lrn,level,X'channel',device.name,rec.size, 

N,,,ooerator.terminal.name 

ATD lrn,level,X'channel'.modem,speed,device.type,I del), 
tstop-bitlt ,parity ] 

In either case, the logical resource number (lrn) on the DEVICE 
directive must be explicitly specified and must be non-zero. The lrn 
you specify will be assigned to the device and the file having the 
name ‘•device-name" (fifth oarameter) . The system implicitly assigns 
lrn 0 to the file having the name "operator term!nal.name" (tenth 
parameter). Lrn 0 may not be assigned to any other device. An 
appropriate level number and channel number may be specified. The 
device name (fifth parameter) you specify will be assigned to the 
terminal when it is functioning as a non-operator terminal. An 
application task group's standard I/O files (e.g., command-in, 
user-in) will be assigned to the device name you specify.(l) You 
must specify that this device is unbuffered* the seventh parameter 
must be N. 

For an MOC—co nnec ted terminal, the tenth parameter in the DEVICE 
directive designates this device as being able to function as both 
an operator terminal and a non-operator terminal. For an 
MLCP/DLCP—connected termina1, the tenth-parameter, operator 
term! na l.name, must be separated from the seventh parameter, N, by 
exactly 3 commas. The operator terminal name you specify will be 
assigned to users' standard I/O files when the terminal Is 
functioning as an operator terminal. CONSOLE is the cur tomary 
deslgna tion.(2) 

( 1 ) 

Only one aopllcatlon task group can be assigned to the device name 
you specify. 

(2) 

Any number of application task grouos can be assigned to the 
operator terminal name you specify. 


\ 
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Example I * 

DEVICE CON00.9,12,X'1 380 * ,VIP01,100 .N,'7200^ ,, CONSOLE 

In this example, the operator terminal Is connected to an MDC. The 
device unit name Is CONDO. The logical resource number (lrn) is 9. 
The explicitly stated lrn value of 9 is assigned to the terminal 
when It functions as a non-operator terminal. An lrn of 0 Is 
Implicitly assigned to the terminal when it functions as an operator 
terminal. The priority level Is 121 The channel number Is 1380, The 
name assigned to the terminal is VIP01, The record size for file 
system access is 100 bytes. The seventh parameter must be N, 
specifying that this device is unbuffered. The terminal type for 
this device is 72001 The default for visual disolay mode has been 
accepted. The name assigned to the terminal when it is functioning 
as an operator terminal is CONSOLE. 

Example 2* 

COMM 8 

DEVICE\ATD0G,9,15,X'Fr80',VIP00,80,N ,,^CONSOLE 
AID 9,15 tX^FFSO^ ,0,9600., 7200 

In this example, the operator terminal is connected to an MLCP. 
The device unit name 1s ATDOO. The logical resource number is 
9 * The explicitly stated lrn value of 9 Is assigned to the 
terminal when it functions as a nonoperator terminal. An lrn of 
0 is implicitly assigned to the terminal when it functions as 
an operator terminal. The priority level is 15.' The channel 
number Is FF80. In the COMM directive, 8 is the priority level 
at which,the WLCP/DLCP will ihterruo t the central processor. 

In the DEVICE directive, the name assigned to the device when 
It is functioning as a non-operator terminal is VIPOO. The 
record size for file system access is 80 bytes. The terminal 
must be designated as unbuffered (the seventh parameter must be 
N). The name assigned to the terminal when It is functioning as 
an operator terminal is CONSOLE. 

In the ATD directive, the modem tyDe is 0 (direct connect). The 
line speed is 9600. The device type is 7200. Defaults have been 
taken for del, stop-bit, and parity. 

At system startup, the terminal is running under the system 
task group and functions as an operator terminal. The initial 
switch from operator control to user control must be 
accomplished through an EC file you create. The location and 
purpose of this EC file should be communicated only to selected 
users. 


The EC file must contain the following commands* 


OPER -OFF 


-IM ‘ 

.” DEF . 


SO grouo„Id user_id level user_in -WD path -POOL doo l_id 
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The OPER -OFF command transfers control of the terminal from 
operator control to user control. The -IM control argument (the 
default) allows all messages processed by the operator Interface 
Manager (OIM) to be displayed while the terminal Is running under an 
application task group. 

The -Q£F control argument defers all olM-processed messages until 
the terminal Is returned to system task group control. However, 
messages sent to the terminal by two system routines. OPMSG and 
OPRSP, are never deferred. These messages are displayed Immediately 
to allow the operator or user to respond to volume mount reauests or 
'device not ready' messages. Messages sent to the terminal from 
other terminals using the MSG command are also not deferred. If a 
user soecifies the -DEr argument and the OIM has deferred an outout 
order* the OIM will Issue a message at regular intervals stating 
that outout Is pending. 

The spaw group (SO) command initiates the aooropriate user grouo for 
the application. The spawn grouo command creates an application task 
group whose lead task must be the command processor. (The CG and EGR 
commands may be substitued for the SG command), the user-in file 
must be the same as the 'device—name' soecified in the OEVICE 
directive when the terminal was configured. 

If a user wishes the terminal to function as an operator terminal, 
he must execute the command OPSR -ON, A message will appear at the 
terminal stating “OPERATOR HAS CONTROL”. If at any time, a user 
wishes to return control of the terminal to his aopllcation task 
group, he must type the command OPER -OFr. 

System Configured Without Operator Terminal 

A system configured without an operator terminal has the following 
character itics * (1) 

. A $OP!13G (operator information message) or SOPRSP (operator 
resoonse message) macro call to the nonexistent operator 
terminal results in a 0802 error return (invalid logical 
resource number) to the issuing aoollcatlon. 

. No operator terminal is available to record system error 

messages, ready device messages, and mount volume messages* As 
a result, error returns to the issuing aopllcation occur 
immediately * 

- An inout/output order to a device that is offline or not 
ready results in a 0105 error return (device not ready) to 
the aoplication. 

( 1) 

In a system configured with an operator terminal, these same 
characteristics aoply within any task group that has used the 
$CMSUP (console message suppression) macro call ti temporarily 
suppress messages to the operator terminal. 
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- A GET command or SGTrIL (get file) macro call to reserve a 
volume that is not mounted results in a 02OC error return 
(volume not found) to the aoolieation. 

- A read or write hardware error results in a 0107 error return 
(hardware error) to the apollcation. 

. No system-supolled message can be issued to signal the 
termination of system startup. 


File System Pathname in CLM Directives 


Whenever the format of a Configuration Load Manager (CLM) directive 
indicates that a file system pathname is to be suoplled as an 
argument, the oathname must be expressed in one of three forms* 

1* A full absolute pathname. 

This form of pathname is reouired to identify a file on a disk 
volume other than the system (bootstrao) volume. 

A full abosulte pathname begins with a circumflex <*> and a 
disk volume root directory name (which is the same as the 
volume.ld). Each successive element in the pathname is 
preceded by a greater-than sign (>) and is hierarchically 
subordinate to the preceding element. Every element in the 
pathname except the last is a directory name. The last 
(rightmost) element is a file name*(!) The last element is 
not followed by any symbol or punctuation. 

Example * 


CLMIN ~USRVOL>DIR_l>rILE.A 

In this example, a full absolute pathname is used in a CLMIN 
directive. The pathname indicates a target file that exists 
on a disk volume other than the system (bootstrao) volume. 

2. An absolute oathname. 

This form of pathname is used to identify a file on the system 
(bootstrap) volume or a nondisk oeripheral device. 

An absolute pathname begins with a greater-than sign (>) and 
. ... . the name of a directory or file that is immediately 

subordinate to the root directory of the system volume. The 
rest (if any) of the pathname is similar to the full absolute 
pathname described above. 


( I) 

In .lOn-CLM environments, the last element in a pathname may be 
either a directory name or a file name, as appropriate to the 
situation. 
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For a magnetic tape file, the absolute pathname must be 

!device_unit>volume_id>f11e^name. The value for device_unit must be 

specified in the related DEVICE directive. 

For other nondisk peripheral devices# the absolute pathname must be 
!device_name. The value for deviee_.name Is as specified in the 
related DEVICE directive. <If device.name is not specified in the 
DEVICE directive, the value of the device.unit argument is used for 
devlce.name# 

Example* ' - 


ORIVER >DIR_V>USRDRV 

In this examole, an absolute pathname is used in a DRIVER 
directive.' This pathname indicates a target file that exists 
on the system volume. DIR_Y is a directory immediately 
subordinate to the root directory of the system volume. 

3. A Relative pathname. 

During execution of the Configuration Load Manager, this form 
of pathname is used to identify a file in this system task 
group's working directory. In this case directory SID, which 
is immediately subordinate to the root directory of the system 
volume. <“Relative* means relative to the working directory of 
the task group). 

In this situation, the relative pathname is exoressed as a 
simple file name with no preceding or following symbols or 
ounetuation.(1) The named file must exist in directory SID on 
the system volume. 

Example * 


LDBU RBRCIP 

In this examole, a relative pathname is used in an LDBU 
directive. This pathname indicates a target file that exists 
immediately subordinate to directory SID on the system volume. 

In all types of pathnames, a directory name cannot exceed 12 
characters, a file name cannot exceed 12 characters, and the total 
pathname (including * and > characters) cannot exceed 57 characters. 
In a full absolute pathname, the volume root directory cannot exceed 
six characters. The first character of each directory name and each 
file name must be alphabetic or a dollar sign <$). 

( I) 

Other forms of the relative pathname exist, but their use with the 
Configuration Load Manager is discouraged. 


I 
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CLMIN 

CLMIN DIRECTIVE 


Directive Names CLMIN 

A CLMIN £CLM Input) directive causes the source of CLM directives to 
be changed from the current device/file to the one indicated by the 
pathname argument c All subsequent CLM directives are read from the 
indicated deviee/file (unless it too contains a CLMIN directive). 


Format* 

CLMIN pathname 


Argument Description* 
pathname 

Consists of an ASCII string that identifies the file system oathname 
from which subsequent CLM directives will be read. 


Functional Description* 

In a file of CLM directives* a CLMIN directive cannot aopear ahead 
of the DEVICE directive that identifies the device implied by the 
pathname argument. 

When a CLMIN directive Is read by the Configuration Load Manager* 
the Input file is Immediately transferred to the beginning of the 
device/file indicated by the pathname. Subsequent CLM directives are 
read from the indicated device/file. 

If a disk or magnetic tap# volume is indicated by pathname* that 
volume must be mounted before system startup begins. 

Example I * 


CLMIN ~ABCDVOL>BETAI 

In this example, subsequent CLM directives will be read from a file 
named BETA! on disk volume ABCVOL. An absolute disk pathname Is 
used. Volume ABCVOL must be mounted on a disk device whose DEVICE 
directive has already been reed by the Configuration Load Manager. 
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Example 2* 

CLMIN !CDROO 

In this example, subsequent CLM directives will be read from card 
reader whose devlce.unlt name Is CDROO. (Assume that the DEVICE 
directive for CDROO did not include a device.name argument! In this 
case, the device M unit argument value Is used for file system 
references to the device).. The DEVICE directive for CDROO must 
already have been read by the Configuration Load Manager. 
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COMMENT 


COMMENT DIRECTIVE 
Directive Name* * (asterisk) 

The COMMENT directive is used to include a comment in the file of 
CLM directives. 

Format* 

* Comment text 


Functional Description* 

rthen an * (asterisk) is the first character of an entry in the file 
of CLM directives, the remainder of the entry is treated as a 
comment and is not processed by the Configuration Load Manager, 

Comments can also be included on other CLM directives if they follow 
a blank after the last argument of the directive. 
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DEVICE 


DEVICE DIRECTIVE 


Directive Name* DEVICE 

A DEVICE directive is required for each MDC-connected peripheral 
device In the system* You may allow the system to dynamically 
assign channel numbers to appropriate devices on the bus* You must 
include a special format of the DEVICE directive in your CLM file if 
your installation will use a dual-purpose operator terminal. Refer 
to "Configuring a Dual-Purpose Operator Terminal" earlier In this 
section. 


Format * 


DEVICE 


device_unit,irn,level,X'channel',Cdevice_name], 
Crecord_size),C {n} ],['terminal-type^][,C/T1 


Argument Description* 
device_unit 

A string of five ASCII characters. This first three characters 
identify the type of device! the last two characters (alphanumeric) 
must be unique wl thin the device type so as to Identify one sped fic 
device of that type. Table 5-2 Indicates the permissible values of 
devlce.unlt, the device type indicated by each value, and the 
default physical record size (in bytes) for each device type. 

Except where indicated, the default record size can be overridden by 
use of an explicit record_size argument in the DEVICE directive. 

In the case of KSRnn, the device_unit argument also establishes the 
following characteristics for the termina1 * 

* Trailing carriage return ootion specified. 

. Trailing line feed option specified. 

. Leading control byte ootion specified. 

. Echo mode option specified. 

If you wish to change any of these characteristics of the terminal, 
you can do so by means of an'.STTY (set terminal characteristics) 
command, a SSTTY macro call, or a STTY directive* 
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Taole 5-2. Unit Values and Default Reeord for Various Device <d) 




Default Physical 

Device_Unit 


Record Size in 

Value 

Device Type Indicated 

Bytes (Decimal) 

KSRnn/CONnn 

a 

Terminal (MDC-connected) 

KSR-73 CON-80 

LPTnn 

Line Printer 

1 37 

SPTnn 

Serial Printer 

133 

CDRnn 

Card Reader 

80 

CRPnn 

Card Reader/Punch 

80 

DSKnn 

Diskette 

128(b) 

RCQnn 

Removable Cartridge Disk 

256<b) 

FCDnn 

Fixed Cartridge Disk 

25ft(b) 

MSMnn 

Mass Storage Unit 

256(b) 

RCMnn 

Removable Cartridge Module 
Disk 

25ft(b) 

FCMnn 

Fixed Cartridge Module Disk 

256(b) 

MT7nn 

Magnetic Taoe (7-track) 

0(c) 

MT9nn 

Magnetic Tape (9-track) 

0(0 



The KSR device_unit value is included for comoatlbility with 
previous releases* The COM device_unit value should be used when 
creating a new CLM directive file* The COM device_unit value must 
be used if the user intends to perform forms processing from an 
MDC-connected VIP 7200 or VIP 7205 terminal* Using the KSR 
deviee„unlt value and the CON deviee_unit value will cause two 
different device handlers to be loaded,, 


b 

The default record size for this device cannot be altered by means 
of the record_size argument of the DEVTCE directive. 


It is not necessary to issue a GET command or a SGTFIL (get file) 
macro call to establish the logical record size (and block size). 
The record size cannot be altered by the record_size argument of 
the DEVICE directive. 


d 

Communications devices are described in Section VI. 


Irn 

Specifies the logical resource number by which the device Is 
requested. The value for irn Is a decimal integer from 3 through 
252. (Irn 0 is used for the operator terminal. Irn 1 is used for the 
bootstrap device. Irn 2 is reserved for system use). 
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level 

Specifies the priority level used by the device driver for this 
device.' The value for level is a decimal integer from 7 through 59. 


X'channel' 

Specifies the 4-digit hexadecimal channel number of the device. (The 
leftmost 10 bits specify the channel number* the righmost six bits 
must be zero)• 

If you specify the channel number by a single zero (0), the system 
will automatically assign this device to an appropriate channel. 

If a DEVICE directive for a disk device contains an Irn of I and a 
channel number of zero* the bootstrap device channel number replaces 
the channel number of zero. 


(device_name] 

For disk and magnetic tape devices, the device_name argument must be~~" 
omitted or specified as * (asterisk) because the device identity is 
established by the value of the device^unit argument. (The 
significance of using the asterisk is described below). 

For devices other than disx or magnetic tape, device_name can be one 
o f the following * 

1. A string of up to 12 ASCII characters that establish a unlaue 
name by which the device is referred to within the file 
system. The first character of the string must be alphabetic. 

2. Omitted* in which case the value of the device^unit argument 
is used for file system references to the device. 

3. An * (asterisk)* which Indicates a "private** device to be 
accessible only through physical input/output. 


[record_size) 

The length, in bytes, of one physical record. If record_size is not 
specified* the default record size Is as established by the 
devlce_unit argument. (The default record size for disk devices and 
magnetic tapes cannot be modified by the record.size argument). 

[»>] 

This argument is meaningful only for devices other than disk and 
magnetic tape. 
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DEVICE 


For normally unbuffered devices (viz., CDR, CRP), B Indicates that 
input/output to the device is to be buffered. 

For normally buffered devices (viz., CON, KSR, LPT, SPT), N 
indicates that input/output to the device is to be unbuffered. 

Input/output to a buffered device may be either asynchronous or 
synchronous l tabulation characters are exoanded into space 
characters. Input/output to an unbuffered deviee is always 
synchronous ! tabulation characters are not expanded. 

NOTH* All arguments of a DEVICE directive must be unique (i.e., not 
dupileated on another DEVICE directive) with these exceptions* 
Ci) the B/N argument need not be unique, (2) for pairs of 
removable/fixed cartridge disks, the same level number and 
channel number must be specified for both platters (3) 
multiple communications devices may be configured on the same 
level and (4) multiple (polled) VIPs may be configured on the 
same channel. 


t -''terminals type') 

Applies only if the device_unit value is CON. Specifies the physical 
terminal type. Possible values are described below* 


Value Physical Device Type 

'7200' VIP 7205 (DKU9103) 

VIP 7205 (DKU9IG2) 

' The value 7200 must be used if MDC-connected 
VIP 7200 terminals are to be used for forms 
processing using the Display Formatting and 
Control Facility. 

'PRO' PRU1001/PRU) 003/PRU ) 005/TWU1001 /T ft U1 003/TW U1005 


'D7200' VIP 7207 

'KSR' The value KSR is used if the physical terminal 
type is to be supoorted in teleprinter mode. 


* 


CC/TJ 

Applies only if the device.unit value Is CON. Specifies the visual 
display mode for the device. The value C indicates CRT mode*. The 
value T indicates teleprinter mode. If C is specified, typed input 
will aopear without edit control characters (as it appears in the 
memory buffer). If T is specified, typed input will aDpear as it was 
keyed-in. The default value is T. 
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Functional Description* 

Each Derlpheral device in the system must be identified In a 
separate DEVICE directive* The devlce.unlt argument (e.g., DSK01) 
Identifies both the type of device (DSK) and one specific device 
(01) of the Indicated type. The lrn, level* and charnel number of 
each device must be unique (except in the case of a pair of 
removabie/fIxed cartridge disks, in which case the level and channel 
for both platters must be the same). 

f 4 - 

The first DEVICE directive for each device type causes the 
appropriate device driver to be loaded as part of the system. Each 
device driver Is re-entrant, so that only one copy of each required 
driver Is loaded to service all devices of the same type. 

A DEVICE directive for the bootstrap device Is optional. If none is 
specified, the bootstrap device is assigned priority level >5 (the 
default). If you wish to override the default priority level* you 
should specify a DEVICE directive that Indicates the anoroprlate 
device^unlt, logical resource number I, desired oriority level, and 
a channel number of zero (e.g., DEVICE 0SK00,1,ieve1,X'O'). If the 
channel number is not zero, the following message is Issued* 1345 
CMD (DEVICE) SPECIFIES DUPLICATE DEVICE TYPE/UNIT. 

Example 1 * 

DEVICE LPT01,12,20,X'I38CK 

In this example, the line printer whose unit number 
is 01 Is assigned logical resource number 12 and 
priority level 20. This device Is connected to 
channel 1380. The following characteristics are 
established by default* 

. The devlce_name used within the file system will be the same as 
the devlce_unit (i.e., LPTOI). 

. The record size will be 137 bytes. 

Example 2* 

DEVICE RCDO1,9,10,X'1400' 

DEVICE FCDO1,6,10,X'1400' 

This example Illustrates DEVICE directives for a pair of 
removable/fixed cartridge disks. The logical resource number for 
each olatter must be unique. The level and channel number for both 
platters must be the same. 
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DRIVER 


ORIVES PI RECTIVS 
Directive Name* DRIVER 

The DRIVER directive is used to Identify a user-written device 
driver and one device driven by the driver. 

Format* 

DRIVER pathname,lrn, 1 evel .X'channel't . X'stack_sizel 
RCT.size'H .X'hhhh'l 

Argument Description* 
pathname 

An ASCII string that identifies the file system pathname of the 
device driver bound unit. 


lrn 

Specifies the logical resource number used to identify a device 
driven by this driver. The value for lrn is a decimal integer from 3 
through 252. 


level 

Specifies the priority level used by the device driver. The value 
for level is a decimal integer from 7 through 59. 


X'channel' 

Specifies the 4-digit hexadecimal channel number of a device driven 
by this driver. (The leftmost 10 bits specify the channel number* 
the rightmost six bits must be zero). You have the option to allow 
the system to assign a channel number for this device by specifying 
a single zero for this argument. If you choose this option, you must 
also specify the X-'hhhh' argument described below. 


C X'stack_size!RCT_size3 

Specifies the sizes in words of (1) the stack required by this 
driver and (2) the resource control table (RCT) used for a device 
driven by this driver. The sizes are specified by a four digit 
hexadecimal number* the leftmost two digits specify the stack size; 




the rlghmost two digits specify the RCT size, if the stack size ^ 

and/or the RCT size exceed 255 words (decimal) you may use the jq 

double word hexadecimal format, D'hhhhhhhh^, where the first four ^ 

hexadecimal digits represent the stack size and the second four 5; 

hexadecimal digits represent the RCT size. If the driver Is to use ill 

the system routine ZIOSUB, the stack size must be at least 22 words 
for a SAF configuration and 40 words for a LAF configuration. The 
minimum size for the RCT is 3 words. If a smaller value is entered, 
the system replaces it with 3. The default values are 8 words for 
stack size and 1 6 words for RCT size. You must take the default 
values for both sizes or specify both. You cannot specify one and 
take the default for the other. 


[X'hhhh'] 

Specifies a four-digit hexadecimal number corresoonding to the 
internal hardware id of the device being driven by this driver. 


Functional Description* 

The DRIVER directive causes the user-written device driver 
identified by the pathname argument to be loaded into the system 
area of memory. (Because this driver is loaded into the system area 
of memory, the SYS Linker directive must have been specified when 
this bound unit was linked). The user-written device driver becomes 
a permanently resident part of the system software. (If the driver 
includes initialization routines to be executed when the driver is 
loaded, these routines also remain permanently resident). 

The DRIVER directive causes creation of a resource control table 
(RCT) of the Indicated size. It also causes creation of a task 
control block (TCB) with a dedicated priority level. Additional data 
structure initialization is achieved as described below. 

The data structures allocated for use by this device driver are 
sufficient only for physical input/output ooeratlons. The RCT will 
be used by the driver to interface with the indicated device. 
InDut/output from a program can be initiated by a SRQIO (reauest 
input/output) macro call that Identifies an aooropriate input/output 
request block (I()RB). (The format of the IORB is described in the 
System Service Macro Calls manual). 

Each user-written device driver runs at a dedicated (unique) 
priority level. If a given device driver (single task) drives 
multiple devices on different channels, one DRIVER directive is 
required for each device. Each DRIVER directive must specify a 
unique Irn and channel number, and a common oriority level and 
oathname (see the examole). In this case a separate RCT and stack 
are created for each device but a common TCB is used* Multioie 
devices of the same type, each with its own work area, are thus 
driven at a common priority level by a common task. (If a given 
device driver drives multioie taks, the pathname arguments In each 
DEVICa directive must be identical, but each task must have a unique 
oriority level). 
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The initialization of data structures caused by the DRIVER directive 
is summarized below* 

. An ROT of the indicated size is created. Immediately below the 
RCT, space for a pointer to the TCB is provided! one word for a 
SAF system, two words for a LAF system. 

• The RCT Is Immediately preceded by a TCB pointer which is in 
turn immediately preceded by the stack. 

. The pointer at the appropriate Irn offset in the logical 

resource table (LRT) is set to point to the channel/level word 
(the first word) of the RCT. 

• The TCB pointer immediately below the RCT is set to point to 
the TCB. 

. The channel and level values of the DRIVER directive are 
entered into the channel/level word of the RCT. 

. The RCT is marked as having no volume descriptor block (private 
volume). Thus the device is accessible only through physical 
input/output (normally, the sRQK) macro call) and not through 
the file system. 

. The TCB is marked as having a dedicated priority level. (The 

' TCB is also set to point to the entry point of the device 
driver). 

• The remaining area of the RCT is set to zero. The driver must 
initialize the RCT as required. 

Example» 

DRIVER DIRECTORY,.! XlrtNJDRIVER,I2,9,X'030CK 
DRIVER DIRECTORY.,! >OWMJDRI VER, 

In this example, a user-written device driver whose file name in 
OWN^DRlVER is identified. It will be used to drive two devices under 
a single task. The level and pathname arguments of the two DRIVER 
directives are the same! the logical resource numbers and channel 
numbers for the devices are unique; The RCT for each device will be 
16 words* The size of the stack required by this driver is 8 words. 
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LDBU OIBECTIVE 


Directive Name* LDBU 

The LDBU directive causes the Indicated bound unit to be added to 
the end of the bound unit load list. The bound unit's root 1$ loaded 
into the system area of memory after all CLM directives have been 
read. (Since the root of the bound unit will be loaded into the 
system area of memory, the SYS Linker directive must have been 
specified when this bound unit was linked). Once loaded, the root of 
the indicated bound unit is permanentely resident in the system. 

If you wish to Incorporate an optional system capability into your 
configuration, such as error logqing or defective memory trap 
handling, you might be required to load one or more bound units 
using LDBU directives. Refer to Sections VII and VIII for 
descriptions of the bound units associated with optional system 
capabilities. 


forma t * 


LDBU pathname 


Argument Description* 


pathname 

An ASCII string that identifies the file system pathname of the 
bound unit. 


functional Description* 

Application-specific code (usually in the form of subroutines shared 
among multiple task groups) that is referred to symbolically during 
application execution can be permanentely brought into memory at 
system startup by LDBU directives. The oathname in each LDBU 
directive is added to a bound unit load list. 

The order of LDBU directives governs the order in which pathnames 
are added to the list. If two LDBU directives specify the same 
pathname, the second one is Ignored. 

After the QUIT directive (the last CLM directive) is read by the 
Configuration Load Manager, the roots of the bound units identified 
by LQ3U directives are permanently loaded into the system area of 
memory. The symbol table for each such bound unit is added to the 
system's resident symbol table list. Once a bound unit has been 
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loaded, any symbol defined therein by an EDEf Linker directive 
serves to resolve an unresolved reference to that same symbol in a 
subsequently loaded bound unit. Otherwise, if a bound unit contains 
an unresolved reference to a symbol, loading stops with an error 
halt. 

Example * 

LDBU *ABCVOL>ALPHA! 


In this example, a bound unit named ALPHA!, which is a file 
immediately subordinate to the root directory of a volume named 
ABCVOL, will be added to the bound unit load list, 

A bound unit loaded by means of the LDBU directive may contain an 
initialization subroutine table (1ST), The 1ST defines one or more 
subroutines of the bound unit that are to be executed once only, 
immmediately after the root is loaded. If a bound unit contains 
initialization subroutines, the Linker directive 1ST must be 
specified when the bound unit is linked. The label in the 1ST 
section is the argument to be entered in the 1ST directive. 


The format of an 1ST section is given below* 


label 


DC 

RESV 

o 1 

SAT, 0 

RrU 


DC 

DC 

DC 

<subl ) 
0° 1 

parameters to subroutine sub! 
be any sixteen bit value) 

(may 

DC 

DC 

DC 

<sub2 ) 
°0 

parameters to subroutine sub2 
be any sixteen bit value) 

(may 


9 

♦ 


( 1 ) 

If the entry is 0, all memory used by the initialization 
subroutines is returned to the system after the subroutines have 
been executed (provided the subroutines have not caused the system 
to create data structures on their behalf). To retain a subroutine 
In memory, specify n, where n is the number of words to be 
retained* In this case, take care not to extend the memory 
requirement beyond that allocated to the bound unit's root when it 
was loaded. 
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DC <subn i oarameters to subroutine subn (may 

DC 0 / be any sixteen bit value) 

DC 0 ) 

RESV $AF,0 End of table sentinel 

sull .*. 


su 12 


subn 


Upon entrance to a subroutine, register 85 contains the return 
address* Before exit from the subroutine, register R1 must contain 
the status* A value of zero indicates correct execution* A nonzero 
value is the error code for this subroutine. If the status is 
non-zero, the following message is written to the error-out file, 
and a halt occurs* Execution of CLM cannot continue* 

1348 INITIALIZATION SUBROUTINE ERROR 

(error code returned to register Rl) 
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MAP DIRECTIVE 


Directive Name* MAP 

The MAP directive provides configuration information that enables 
you to verify the success of certain aspects of the system building 
process.. The information presented by this directive includes the 
system physical attributes* system structures® device status® 
user-defined variables® and memory oooi specifications; This 
Information can be used to ease the debugging of system extensions 
and user-written device handlers. In addition, information (such as 
system symbols) is presented that would otherwise be unavailable. 


Format* 

MAP tpathJ £*map_form,3 £,map_form23... 


Argument Description* 
path 

Pathname of the file to which the maD Using is to be written. The 
pathname cannot be that of a communications device. The pathname 
must be able to, be verified when the CLM reads the MAP directive. 

if the pathname refers to a device file (e.g.® 1LPT00), that device 
must nave been configured when the MAP directive is read. 

If the pathname refers to a disk file, the indicated volume must be 
mounted on the drive of a device that is already configured and 
recognized by the file system when the directive is read. If the 
pathname refers to a disk file that does not exist, the file will be 
created (as long as the directory structure identified in the 
oathname already exists). If the file already exists® It must be a 
variable sequential file. In this case, it will be opened in "renew” 
mode. 

The default map path value is >SID>CLM_MAP. 

C map_form®]..* £map_formn3 

Any combination of the map format arguments described below can be 
entered in any order. If none of these arguments is specified® the 
entire system map is written to the map file. The complete mao 
presents the following Information (in the order shewn)* 

. System physical attributes 

. System structures 
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• User-written device driver attributes 
. Device status for devices accessed by the file system 
. User-defined variables 


. Memory pool attributes 
. System extensions 


. User-selected permanently resident system overlays and system 
overlays made resident to serve as device drivers 

. System symbol table 

(-BRIEF'' 

J-8F 1 

Requests display of only the physical attributes* system structures* 
user-written driver attributes* and user-selected permanently 
resident overlays. 

S -NDcV f 
-NO | 

Omits from the map the data pertaining to device status (devices 
accessed through the file system). 

-NVAR ) 

r v I 

Omits from the map the data pertaining to user-defined variables. 

! -npool) 

-NP ( 

Omits from the map the data pertaining to memory oools. 

)—NRE3 ) 

r R I 

Omits from the map the data pertaining to user-selected permanently 
resident system overlays and system overlays made resident to serve 
as device drivers. 

i-NSYM / 

-NS f 

Omits from the map the data pertaining to the system symbol table. 
Example 1 * 

MAP -NS 


The system symbol table data is omitted from the map. The map is 
written to the map file whose pathname is >SID>CLM_MAP. 
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Example 2* 

MAP iCON SOLE 

The entire map is produced and written to the console* The console 
output in this example is as follows* 



CLM HAP 

* 

PHYSICAL ATTRIBUTES: 

GCU36 MU0400-12.1-05/28/1430 
SIP PRESENT 
NU C1P PRtSENT 
HMU PRESENT 

HIGH PHYSICAL MEMORY ADDRESS: 3FFFF 

HIGH VIRTUAL MEMORY ADDRESS! bEDPF 

TIME BETWEEN REALTIME CLOCK INTERRUPTS: 32 

OPLHATOR CONSOLE CONFIGURED 

ERROR MESSAGE LIBRARY IN USE 

SYSTEM STRUCTURES: (DECIMAL NUMERIC VALUES) 

45 IRHS, 36 ISAS* 10 SYSTEM OVERLAY AREAS* 

0 RECURD LOCKS CONFIGURED 

USER-WRITTEN ORIVtRSt 

£10488 RELOCATIONS 5501 ENO* SH80 ENTRY AOOHESSs S90A 

LRN*20 LE VEL*21 CHANNELsEEOO TCH AT 5BB6 HCT AT 5DED 

STACK ALLUCATIUN SHEA To SUEA 

£10488 RELOCATIONS 5FA0 END* bblf ENTRY ADDRESS? 6479 

LRN«21 LEVEL*22 CHANNEL«COOO TCH AT 6655 RCT AT 670C 

STACK ALLOCATION 6689 TI1 6709 

l 10488 RELOCATIONS 5EA0 fND* 661F ENTRY A00RE3S* 6479 

LHN*2? LEVEL*22 CHANNEL s AOOO TCH AT 665S RCT AT 691C 

STACK ALLOCATION 690H TO 6919 


DEVICE STATUS: (DEVICES VISThLE TO FILE SYSTEM) 


3YMPD CHANNEL 

DEVICE VOLUME 

USAGE 

AVAILABLE. 

.SECTORS 

VOLUME 

MEMBER 

NAME 

TYPE ID 


PHYSICAL 

LOGICAL 

SET NAME 

NUMBER 

« RCDOO 1400 

2332 ‘CHfCKL 

34 

0 

0 



8 M3MQ1 1800 

2361 

D 





B RCOOt 1480 

2332 

l» 





H DSKOO 0400 

2010 *VLh?26 

1 

SO? 

502 



8 OSK01 0480 

2010 *CL« 

0 

154 

154 



B 03K02 1200 

2010 

0 





B D3K03 1280 

2010 *RBT 

0 

1952 

1952 



B CONSOLE 500 

201A * 

2 





B CUROO 1300 

2008 * 

U 





a LPT00 1386 

2002 

1 





USER-0EF1NED CLM 

VARIABLES: 






A a 5 

H 3. 50 

c * 

500 

D s 5000 

E = 

SOOOO 

F s 5555 

J * F EFEFEFE 

8 s 

E'FFFE ECE 

M x 0 

P s 

12C 

<1 s 0 

w = FFFFFCC8 

l a 

EFFFE040 




MEMORY POOLS! 







SS 31 ART=9980 EN&sl OEFE 

S12E» 7580 

VIRTUAL 

BIAS* 0 
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AL 

AK 

AH 

AM 

AN 


AWRIHUTLSs 
STAKT*2000ti 
ATTRIBUTES* 
ST Aft? *30000 
ATTRIBUTES* 
ST ANT *40000 
AtTRlHUUSs 
ST AN T 340000 
ATTRIBUTES* 
STARTsROOOO 
ATTRIBUTES* 


P USER'S RING 

ENOsZOOFF Sl/fcE 
EP USER'S KING 

END*30IFF SI2Es 
tPCStl USER'S RING 

ENps6EiM)F S WE* 
PC USER'S MING 

ENI»s40»3F SI/(s 
CS USER'S RING 

EN0«4O0SF SWEx 
PSU USER'S RING 


NUHHfcRs 
1 00 

NUMBtH* 

ZOO 

NUMBERS 

2EDE0 

NUMBENS 
MO 

NUMBERS 

60 

NUMBERS 


0 

VIRTUAL BIAS* F100 
1 

VIRTUAL BIAS* 1F000 

2 

VTRIUAL BIAS* 2EE00 

1 

VIN tUAL BIAS* 2EE00 

S 

VIRTUAL BIAS* 2EE00 

2 


LOMU'S* (SYSTEM EXTENSIONS) 

Z1U4BA SI ART* 5501 
Z104RA SI AN f £ 5FAG 
ZXOEFM STARTs 7006 
OVLYCT STARTs 7EPE 
VIDEO SIANTs «E3E 


RE SOLA'S: (REKMANtNIl T NESIUFNl EXECUTIVE OVERLAYS) 


cm 

SI AH 1S4B9D 

0 

01 OUR 

SfARTS31L2 

t 

OIULH 

START **»3E 3 

OTOCR 

SIAKISS20B 

9 

ttXPCLl 

SfARI sBFBA 

0 

nmiMS 

SIAHTsBAEB 

MXPCL2 

$1AHtsVlTO 

0 

OXGR W 

STAR)*0 777 

9 

OXPCLi 

S TARtS9001 

III 01 MO 

S1 ART SH9HA 

0 

OI01M3 

S1AR1 SUDAN 

t 

mm |NU 

START sHS33 

IIUKUM2 

SIAHIsBMOE 

9 

0UENS2 

Sf AHT3N34A 

0 

UYASF 

SI ARTSR777 

IlYCNN 

SIARTsBOMO 

9 

OY I | 

S f AH T *B61 7 

0 

M/AVH2 

S1AKT*94At 

U/ACCB 

S1 AH|SH360 


UZXER 

STAHT*V6A0 

t 

UYCKPT 

START 3BH02 


SYSTEM SYMBUL IABLF t 

Z3EXEC 

LUCAHUNS 


ZtllSUB 

£ 

E50 

ZXSTMX 

£ 

116E 

ZXVLO 

£ 

m;2 

/IOREM 

m 

1097 

/I ATON 

£ 

1110 

ZMHSVII 

S 

BOO 

Z«USP() 

£ 

AFE 

ZMRSVU 

S 

R 1 0 

/MRSPII 

s 

HOI 

/MSNAP 

£ 

AF2 

ZMRLlIU 

£ 

AFS 

2MRLIN 

£ 

AFB 

ZMRASD 

£ 

AFB 

ZTOAOP 

£ 

M57 

ZIOERP 

£ 

H3R 

ZIKE NO 

g 

f OH 

/lOTRM 

£ 

E OA 

/MROmN 

£ 

H|f 

/XMCLX 

£ 

TUAE 

/MS st; 

£ 

IE (4 

ZXSPKU 

£ 

1 BBl 

ZXSPI 

£ 

itch 

/ xi;h I 

S 

icru 

/MAC U 

s 

IE IE 

ZXSEIP 

m 

1?4H 

/XC_SI 

£ 

20E 5 

/XIPSI 

£ 

14.4H 

ZxrTsa 

«Er 

TDCC 
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MEMPOOL 


MEMPOOL DIRECTIVE 


Directive Namei MEMPOOL 

A MEMPOOL directive defines a system memory pool v a batch memory 
pool, an exclusive online memory pool, or a nonexclusive online 
memory pool. Each MEMPOOL directive describes only one type of 
memory oool, but a single MEMPOOL directive may describe more-than 
one exclusive online memory pool or more than one nonexclusive 
online memory pool. (You have the ootion of expressing the size of a 
memory pool symbolically by defining the size in a VARIABLE 
directive. See the description of the VARIABLE directive elsewhere 
In this section). 


Format 1 * 

MEMPOOL 
Format Z * 

MEMPOOL 

Format 3i 

MEMP<X)L 


S,, 

B,, 


E, 


size I,PI 
size F 


.P 


pool.name. 



size , tX H UJC PI [ CK S ] 
poll.name) 


Argument Description Format I 
S 

The letter S designates a system memory pool. The system memory oool 
must be defined In a separate MEMPOOL directive. If multiple MEMPOOL 
directives have S as the first argument, only the last one is used. 

size 

The size argument is a positive integer that defines the number of 
words requested for the memory pool. To specify a pool size greater 
than 65535C10) words, use the double-word hexadecimal integer 
format (e»g., D'(OAOO'). 

The size of the system pool may also be soeclfied by an asterisk 
<*), In which case CLM will allocate to the system pool all memory 
remaining after MEMPOOL directives specifying explicit sizes have 
been processed. Only one pool may be defined with in its size 
field. Once any pool has been defined this way, no other pool may be 
so defined. 
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If a system memory pool Is not defined In an explicit MEMPOOL 
directive. Its size is set at 3K (3072) words. 

The size of pools must be in multiples of a certain number of words 
and will be rounded to the next highest multiple by CLM. For pool 
that are neither protected nor contained, the size of the Increment 
is 32 words. For pools that are protected or contained the size of 
the increment depends on the Level 6 system In which they are to be 
used as shown in Table 5-3. If a pool that Is protected or contained 
has the potential or extending Into the batch pool, the increment 
for the batch pool must eomoly with that of the extendable pool. 


Table 5-3. Increments for Memory Pools 


a 

Increment 

System 

(Words) 

LAF 


(with 1024K memory) 

64 K 

LAF 


(with less than 1024K memory) 

256 

SAF 


(with 64f( memory) 

4K 

SAF 


(with less than 64K memory) 

256 

a 

Memory pool protection/containment requires 

that the Level 6 central processor possesses a 

memory management unit. 



Suggestions for calculating the sizes of memory oools are given 
after the functional description of the MEMPOOL directive. 

P 

The letter P specifies that the pool is protected; l.e., users of 
other non-overlapping memory pools are prevented from writing into 
It. If the argument Is omitted the pool is not protected. If the 
pool being protected is the system pool, the executive code and the 
system data structures are orotected along with the system pool. If 
the system being configured does not have the VMU, this option is 
not effective, and a warning diagnostic Is Issued. 


Argument Description Format 2* 

B 

The letter B designates a batch memory pool. A batch memory pool can 
be specified only once, in a separate MEMPOOL directive. If two or 
more MEMP(X)L directives have B as a first argument, an error occurs. 
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MEMPOOL 


1 size 

Same as for Format I* 

P 

Same as for Format 2* 

MC 

C 

The letter C specifies that the pool is contained* i*e., users of 
the pool are prevented from writing outside of it* The letters NC 
specify that the pool is not contained* The default for batch is 
contained. If the system being configured does not have an MMU, no 
pool may be contained and non—containment is the default* 


Argument Description Format 3* 


mull 

E indicates an exclusive (non-overlapping) online memory pool. A 
MEMPOOL directive that has E as its first argument defines one or 
more exclusive online memory pools. Even if your MEMPOOL directive 
defines more than one exclusive online memory pool, you need to 
specify E only once (as the first argument). See Example 5. All 
exclusive online memory pools defined in all MEM?CX)L directives with 
E as their first argument constitute a pool set* 

A null (no entry) first argument indicates a nonexclusive 
(potentially overlapping) online memory pool. A MEMPOOL directive 
with a null first argument defines one or more nonexclusive online 
memory pools. 

Each of these sool sets is an alternative definition of the same 
physical area of memory. All pools defined by a single MEMP<X)L 
directive must be either exclusive or nonexclusive* 

?ool_name 

The 2-character ASCII name that uniquely identifies each exclusive 
and nonexclusive online memory pool. The pool..name is used in CG 
(create group) and SG (sparfn group) commands and in $CRGRP and 
SSPGRP macro calls. 

If the oool^name begins with a decimal digit, the pool_name argument 
must be surrounded by apostrophes (e.g., - / IA / ). 

A pool„name argument should not be included in a MEMPOOL directive 
for a system memory pool or a batch memory pool. The omission of the 
3ool_name argument in these cases must be signified by a comma. 

MOTE* At login you can (1) specify the two character identification 
of the memory pool, or (2) specify a single character and 
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accept the second character assigned by the facility, or (3) 
omit the pool identification and accent a two-character 
identification whose first character is L. 

If you login by method (2), all online memory pools to be used 
by the login facility must have the same first character in 
their pool name arguments! This shared first character should 
not be assigned to any other memory pool. In addition, it is 
advisable to assign second characters starting with digits 0 
through 9 (in order), then letters A. through Z (in order)* 
this practice will optimize the efficiency of the algorithm 
used by the system's logic facility when it searches for an 
available memory pool. 

You can login by method (3) in the same way as for (2) except 
that the first character must be L. 

If you login by methods (2) or (3), you should define at least 
as many memory pools as the number of users who may 
consurrently gain access to the system. 


size 

The description of the size argument for Format I also applies to 
Format 3. If an asterisk is not used to define the size of the 
system pool, it may be used to define the size of an exclusive or a 
nonexclusive online memory oool. In this case the pool size is 
calculated by CLM. CLM will allocate to this pool all memory 
remaining after MEMPOOL with explicit sizes have been processed. 

)nce the size of an exclusive pool has been defined with an 
asterisk, no subsequent pool may have Its size defined by an 
asterisk. Once the size of a nonexclusive pool has been defined with 
an asterisk, no more pools may be defined on that directive line. A 
subsequent pool directive may define the size of a nonexclusive pool 
with an asterisk if the pool is the last pool defined by that 
directive. The size of an exclusive pool may be defined with an 
asterisk if the size of a nonexclusive pool has been defined with an 
asterisk. 

oool.nameI 

This option allows the user to refer to a given pool by two (or 
more) names. Pool^iamet is the name of a pool specified by a 
orevious MEMPOOL directive* pool_name is the new name. The 
attributes of the pool are specified by the original directive and 
cannot be changed by subsequent directives that use this option. 

EX] 

The letter X indicates that the online oool can be extended into the 
batch pool area. If a memory request cannot be satisfied with in the 
defined size of the online oool, the contents of the batch pool are 
rolled out of memory. If X is omitted, the online pool is not 
extendable. If the contents of the batch pool are to be rolled out 
of memory upon a SSPB (suspend batch) operator command, at least 
online must be defined with an X argument. 
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MEMPOOl, 


tU] 

The letter U soeeifies that groups using this pool run in the 
unprivileged mode. Groups running in the unprivileged mode may not 
execute privileged instructions and will trao if a privileged 
instruction is attemDted. The default is oriviieged. 

EFJ 

Same as for format 1. 

* 

CC3 

Same as for Format 2, except that for pools defined by format 3 the 
default is not contained. 

ESI 

The letter S specifies serial usage of the ooolI i.e,, only one 
group at a time can use it. An attemot to create a second group 
using a serial usage oool results in an error return and the second 
group is not created. If this argument is omitted, the oool can be 
used by more than one grouo at a time. 


functional Description* 

Each *EMP(X)L directive eauses a pool descriptor list to be created. 
Later, after the memory requirements of the system and its 
extensions are known, each oool set is checked to ascertain whether 
it can fit into the remaining available space. If any element or 
pool set is too large, an error occurs. 

The Configuration Load Manager creates a file named ROILGUT under 
the SID directory of the bootstrap volume if a batch memory oool is 
defined and at least one online memory pool definition includes an X 
argument. If a ROLLOUT file is to be created on a bootstrao 
diskette , it is usually necessary to delete unneeded elements from 
the bootstrap diskette (*28/300) and then copy the remaining 
contents of this diskette to a backuo volume (where the remaining 
contents will be consolidated into a consecutive area). This 
technique will provide the largest possible consecutive area of 
unused spaee on the backup volume. Using this backup volume as the 
bootstrao volume, you can ootimize the possibility of successful 
creation of a ROLLOUT file large enough to accommodate the hatch 
memory pool. 

The following discussion of the protect and contain attributes 
applies only to a system having an MMU. The system pool may be 
protected or not. It may not be contained. The batch pool may be 
contained or not. It may be protected or not! but if it is 
orotected, it will be protected only from those pools that have no 
potential for extending into te batch pool. 

All other exclusive nonextendable pools may he protected, or 
contained, or orotected and contained, or neither protected nor 
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contained. An exclusive pool that Is extendable may also be 
contained. However, when such a pool Is defined, the system does not 
prevent the user from accidentally writing into the batch pool area 
before the batch program is rolled out. 

An exclusive pool that is extendable may also be protected. If such 
a pool extends into the batch pool area, the part in the batch area 
is protected only if there are no other extendable oools. 

The protect and contain attributes apply to all nonexclusive pools 
collectively. If any nonexclusive pool is protected or contained, 
then the set of nonexclusive pools have the same attribute<s). 
Nonexlusive pools may not be individually contained or protected 
from each other. A protected nonexclusive pool, therefore, is 
protacted from exclusive pools or from the batch pool overwriting 
its space. It is not protected from other nonexclusive pools 
overwriting its space. 

Guidelines for Calculating System Pool Memory Size* 

The following tables provide guidance in calculating the size of the 
system memory pool. 

Table 5-4 lists the number of words of resident code required for 
various system components! Table 5-4 also lists the number of 
sharable and/or exclusive flies that are used. 

Table 5-5 lists formulas that can be used to calculate file memory 
space. 

Table 5-6 describes memory requirements for various system control 
structures* 

Table 5-7 describes memory reauirements for elements in online or 
batch memory pools. 

Table 5-3 describes memory requirements for the Message Facility and 
Checicpolnt/Restart (describes in the System Concepts manual). 

The user is advised that the system memory pool must be large enough 
to handle the "worst case" situation. To compensate for pool 
fragmentation, increase the total pool size by at least 10 percent. 
The pool size must be a multiple of 32 words. 
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Table 5=4, Resident Code Required for System Components 


All system components not listed below (and not also the subject of 
a seoarate release bulletin) are less than 200 words. 


Comoonent 

Resident 

Code 

Sharable Files 

Exclusive Files 

Access Control 
Utilities 




Delete Access 
Control 

1 9 080 



Delete Common 
Access Control 

1,080 


! ! 

List Access 
Control 

1 ,545 



List Common 
Access Control 

1 ,545 



Set Access 
Control 

1,180 



Set Common 

Access Control 

1,180 



BULCt) OVERT 

4,969 

Input file 

Output file 

Check Mass 
Storage Volume 

7,273 



Compare 

4,986 

Input file 

Ouptut fIle 


Compare ASCII 

2,616 

Input file 

Ouptut file j 


Copy 

6,356 

Input file 

Output file 

Commercial 

Instruction 

Simulator 

4,500 



Create 

Directory 

380 



Create File 

1 ,280 



Create Index 

1,120 
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Table 5-4 (Cont>. Resident Code Required for System Components 


Component 

Resident 

Code 

Sharable 

1 Exclusive Files 

Create Mailbox 




Create Volume 

10,534 

Output File 

1 CMDUMP etc.) 

Output Volume 

Cata Exchange 

Uti 11 ties 


j 


Compare Data 
exchange 

3,9 35 

! 

Input File 

Output File 

Copy Data 

Exchange 

3,945 


Incut file 

Output File 

Create Volume 

Data Exchange 

t ,500 

i 

Outut file 

rile Change 

Data Exchange 

1 ,285 


Inout file 

List Data 

Exchange 

3,284 


Input file 

Output file 

Debug (SO) 

2,270 


work file 

Debug 

CMulti-User) 

1 ,4 00 
(sy s tern 
pool) 


Work Flle(s) 


1 ,500 

(user pool) 



Quick dreak- 
ooint 

Processing 

3,750 
(system 
poo 1 + 
user- 
s pe c1flad 
site of 
quick 
memory 
buffers 



Deferred Print/ 
Punch 

I ,055 

Input file 


Delete 
■ Urec tory 

790 



Delete Pile 

320 1 


- ■ 
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Table 5-4 (Cent). Resident Code Required for System Components 


Component 

Resident 

Code 

Sharable 

Exclusive Files 

Delete Index 

345 



Display 

Formatting 




Create 

Print 

'/DAM 

'/FORMS command 

4,140 

1 ,406 

7,663 

592 

FORMS>VDAM_FORM_01 


DPEDIT 

SAf 7,345 
LAP 7,748 

Input file 

Output file 


Editor 

7, m 

(+ 2KW oer 
user) 


Input file 

Output file 
Temoorary work 
files tCI-1281 

Export 

2,300 

Input files 

Output files 


rile Change 

1,354 


Input file 

rile Dump 

1 ,625 
(+ 300*/ 
user) 

Input file 

Output file 


Get file 

735 



Det Quota 

5,700 



Interactive 
System 
Definition 
(M4_5fSDEr 

4,777 

C + 4KW Get 
Memory) 

i 

Output file 

Linker 

10,750 
(+ default 
Get Memory 
of 2fCrt) 

Input files 

Output files 

List Creation 
Date 

2,990 

Input file 


List Mames 

4,982 

Input file 

Output file 
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Table 5-4 (Cont). Resident Code Required for System Comoonents 


Compone nt 

Resident 

Code 

Sharable 

Exclusive Files 

List Tape 
Contents 

1 ,417 

Output file 

Input file 

Listener 

2,231 

Input file 


Load Index 

1 ,885 

Output file 


Modify rile 

J ,030 



Patch 

10,2.99 

Input file 
Output file 


Prime Index 

5,790 

Output file 


Print 

I ,507 

Input file 


Print/Punch 

daemon 

6,800 

Input file 
Output file 


Queue Resort 

1,772 

Input file 

Output file 

Rename 

1 ,025 

. 


Report Queue 
Maintenance 

3,000 


Input file 

Output file 

Restore 

3,800 
<+ 2,5.< 
Get 

Memory) 


Input file 

Output file 
+ 1 temporary 
work file 

Reorganize 
indexed Pile 

2,020 

Input file 

Work file 


Save 

2,525 
(+ 2.3K 
Get 

Memory) 

Input file 

Output file 
+ 1 temporary 
work file 

Set Terminal 
Characteristics 

2,135 


~ 

SIP Simulator 
< Double > 

2,000 



SIP Simulator 
(Single) 

600 

J 

- ~ - - - 
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Table 5-4 (Cont). Resident Code Required for System Components 



Resident 



Component 

Code 

Sharable 

Exclusive Files 

Tape 

Positloning 

610 


Input file 

TCLC 

2,900 



TCLP 

See Note 



Unspool 

5,700 

Input files 


Walk Subtree 

800 



ZXDEFM 

(Defective 

Memory Trap 

300 



Handler)*si 1 ZXPRF 
(Power 

26 2 


* 

Resumption 

Facility) 





NOTE* The actual number of words required by the TCLP to Derform 
transaction processing depends on the numoer of concurrent 
users and the mix of transactions they are running. Refer to 
Appendix F in the Transaction Control Language Facility manual 
for the formulas used to calculate tKeTCLP memory 
requirements* 


Table 5-5* Formats for Calculating File Memory Space 


Memory Requirements in a MOD 400 LAF System 

rile Reserved 
Exclusively 

Memory Required for 
System Memory Pool 
(in words) 

96 + (M x 32) where M is 
the number of buffers 

Memory Required for 
Online (User) memory 
Pool (in words) 

64 ♦ (M x Cl size 

2 

where Mis the number of 
buffers 

Sharaole Files 

Memory Required for 
System Memory Pool 
<in words) 

96 + M(32 + Cl size 

2 

where M is the number of 
buffers 

Memory Required for 
Online (User) Memory 
Pool (in words) 

64 
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Table 5-5 (Cont), Formats for Calculating File Memory Space 


Memory Requirements in a MOD 400 LAF System 


file Reserved 
Exclusively 


Sharaole files 


Memory Required for 
System Memory Pool 
(in words) 

Memory Required for 
Online (User) Memory 
fool (in words) 


Memory Required for 
System Memory Pool 
(in words) 


64 + (M x 32) where M is 
the number of buffers 


32 + (M x Cl size) 


where M is the number of 
buffers 


64 ♦ M(32 + d size ) 

2 

where M is the number of 
buffers 


Memory Required for 
Online (User) Memory 
Pool (in words) 


Cl size * control interval size 

MOTH* For all system commands, the number of buffers per file is one 
(unless the user has acted to change this value). 

The control interval size for each command is 512 (unless the 
user has allocated a file with a different control interval 
size), 
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Table 5~6 <. Memory Requirements for System Control Structures 



Word 

Size 



Element 

SAF 

LAF 

Occurrences 

Product 


The number and size of the various control structures will vary 
depending on the installation's processing requirements*. For each 
item in the "Element" column multiply the word size (using the SAF 
or LAF figure, as appropriate) by the number of estimated 
occurrences to obtain a "Product"* then add all the products. 

Batch 3C8 (Includes LFT, L3T 
for LFT+LRN < 47(SAF) 
and LrN+LRN < 28<LAF) 
for every LFM+LRN above 
these limits, add 1 (SAF) 
or 2 (LAF) words. 

96 128 

0 or l 

' 


Batch TCB / s (includes lead 
task, execution commands) 
Witnout SIP 

With SIP 

64 96 

96 128 

0* e *■ 

-r 

Batcn Reauest Blocks 

64 96 

n 


Rollout Caoability 
(Rollout File and Code) 

36 7 44 7 

0 or 1 


Each Active Disk Directory 
and File (include bound 
unit as files) 

64 96 

n 


Per Command„Input/User_Xnput 
File 

Operator Terminal (MDC) 

Disk(a) 

TTY (MLCP) 

PRU, CR 

32 32 

160 160 

64 64 

96 96 

n 

n 

n 

n 


Per User Disk File With 
Concurrency of "Sharable" 
or per "Device File"(b) 
Management (buffer size) 
Disk(a) 

PR, PRU 

CR, KSR 

CI+32 CI+32! 

96 96 ■ 

64 64 

n 

n 


Per Active File (a) 

(buffer control block) 

32 32 

n 


Per Bound Unit 

(File overhead — sharable 
or overlays) 

. 128 192 

n 
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Table 5-6 (Cont). Memory Requirements for System Control Structures l 


Element 

Word Size 

Occurrences 

Product 

SAF LAF 

Per Sharable Bound Unit 

SB US (SAF) * I a + 

5(number of overlays) +■ 

4(number of EDEFed symbols) 

+ code size 

SB US 

Sum of 
SUBS's 


Tape Volume Name Block 

32 32 

n 


Concurrently Outstanding 

Mount Volume Requests 

32 32 

n 


Expanded Trap Save Areas 
for Each Task 

128 192 

n 


System Ove rhe ad 

1 504 1 856 

i 


Total Pool Size Without 
Fragmentation (sum of 

Product column) 

- 

— — - 

■-- ~ 

Fragmentation Allowance 
( 10 oercent of item 
iTcnediately above) 


— - — 

™ — - — 


Legend * 

COB - SrouD control blocx 
LFT - Logical file table 
LRN - Logical resource table 
TC3 - Tasic control block 
SIP - Scientific Instruction Processor 
01 - Disk control interval 


Indexed sequential files must be counted as two files, 
b 

Double the word si 2 e value if the “device file 1 * is bidirectional 
and ouffered. 


Guidelines for Calculating Online and Batch Memory Pool Size. 

The following table provides guidance in calculating the size of the 
online pools and the batch oool. 
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Table 5-7* Memory Requirements for Elements in Online or Batch 

Memory Pools 



Word 

Size 


- -1 

Element 

SAF 

LAF 

Occurrences 

Product 


-1 



The number and size of various 

elements will vary depending on the 

installation's processing requirements 

. For each item in the 


‘•Elements" column, multiply the word 

size (using the SAF or 

LAF 

figure, as appropriate) by the 

number 

of estimated occurrences to 

obtain a "Product"* then add all the products* 



3C3 (includes LFT, LPT) (a) 

96 

128 

n 


for LFN+LRN < 47 (SAF). 
and LFN+LRN < 28 (LAF) 

For every LFN+LRN above 
these limits, add i (SAF) 
or 2 (LAr) words* 





TCB's (includes lead task and 





execution commands)(a) 
without SIP 

64 

96 

n 

"" 

with SIP 

96 

126 

n 


GROuP REQUEST BLOCKS(a) 

64 

96 

n 


Work Space for Commands 





Execution Commands 

192 

192 

n 


Commands From Interactive 

32 

32 

n 


Terminal 





TRS (exclude lead task. 

64 

96 

n 


include execution 
commands) 





Per Commands!nout/User„Input 





File 

De vice 

32 

64 

n 


Disk/Tape 

64 

64 



Per Error - ,()ut/User_.0ut File 





Nondlsk 

64 

64 

n 


Disk 

224 

224 

1 

n 


Per User File (FCB) 

32 

64 

n 


Per User Disk File With 

Cl+32 

Cl+32 

n 


Concurrency of "Exclusive" 
Under Control of Data 
Managementb) (buffer si 2 e) 



! 

i 


Per associate File 

32 

32 

n 
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Taole 5-7 (Cont). Memory Requirements for Elements in Online or 

Batch Memory Pools , 



rford 

size 



Element 

SAF 

LAF 

Occurrences 

Product 

Per User rile Under Control 
of Storage Management 

32 

32 

n 

h * 

Per Nonsharable Bound Unit 
NS3US CSAF) * 18 + 

5<number of overlays) + 

4(number of EDEFed symbols) 

+ code size 

NS BUS 

- 

Sum of 
NSBUS's 

- - 

Per Ronsharable Bound 

Unit (cont) 

NSJUS <LAF) * 25 + 

6(number of overlays) + 

5(number of EDEFed symbols) 

+ code size 


NS BUS 

Sum of 
NSBUS's 

- 

Any Bound Unit With Show 

Load Section 

1 

160 

160 

0 or 1 


1 

User Requested Memory 




_ 

Total ^ooi Size Without 
Fragmentation (sum of 

Product column) 

! 





Fragementation Allowance 
(10 percent of item 
immediately above) 






Legend * 


003 - Grouo control block 
LrT - Logical file table 
LftT - Logical resource table 
TCU - Task control block 
SIP - Scientific Instruction Processor 
TR6 - Task request block 
FCd - File control block 
Cl - Disk control interval 


rthen calculating the size of the batch memory pool, do not include 
this item since, in the case of batch processing, it aopears in the 
system memory pool (see Table 5-6), 


Indexed sequential files must be counted as two files. 
_ 
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Table 5-8. Memory Requirements for Message Facility and 

Checkpoint/Restart 


Component 

User 

Pool 

System 

Pool 

Occurrences 

Message Facility 

System overhead 


192 

I 

ror each task group using 
Message Facility 

64 


n 

ror each mailbox 

160 

128 

n 

For each mailbox with 
disk queuing 


128 

- 

n 

CkeckDoint/Restart 

Permanently allocated 
(for each group using 
Checxpoint/Restart) 

320 

256 

n N 

Dynamically used during 
every Checkpoint (For 
more than 2 tasks in 
the group, add 192 for 
each additional task) 

576 


n 

Dynamically used during 
every Restart 


430 

n 


ixample 1> 


MEMP(X)L S*, 4096 

In this example, a system memory pool of 4096 words is defined, 
because a system memory pool is being defined, no pool_name argument 
is specified, but the second comma indicates omission of the 
argument. 

example 2 * 


MEMP(X)L B,, 12208 

In this example, a batch memory pool of 12,238 words Is defined. 
Because a batch memory pool is being defined, no pool_name argument 
is specified, but the second comma Indicates omission of the 
argument. The batch pool is implicitly contained unless the pool 
size is followed by “,NC“, which specifies not contained. 
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Example J* 


MEMPOOL E,A3,12768,,CD,1024,X 
MEMP(X)L E,£r,2043 

In this example, three exclusive online memory pools are defined, 

•The three pools constitute the set of exclusive online memory oools. 
The first MEMPOOL directive defines two exclusive online memory 
pools* (1) The first, whose pool name is AB, comprises 12,768 
words* it cannot dynamically extend into the batch memory oool 
because argument 4 of the MEMPOOL directive is null, (2) The second, 
whose pool name is CD, comorises 1024 words* it can dynamically 
extend (if necessary) into the batch memory pool because argument 7 
is X, indicating rollout! The second MEMPtXJL directive defines an 
exclusive online memory pool named Er. This memory pool comprises 
2043 words. It cannot dynamically extend into the batch memory oool 
because argument 4 is null. 

Exanple 4* 


MEMP(X)L ,XY,312,,UV,* 

MEMPOOL ,WX,*,X 

In this example, three nonexclusive online memory pools are defined 
(argument 1 in each MEMPOOL directive is null). Each MEMP'XJL 
directive defines a pool set; the first pool set comprises two 
oools, the second pool set comprises one pool. Because two oool sets 
are nonexclusive, they define the same ohysical area of memory 
(i.e., they overlao). Any contention for soace within this area of 
memory will be resolved by the system. 

The first MEMPOOL directive defines two nonexclusive online memory 
oools* (1) The first, whose pool name is XY, comprises 512 words* 
it cannot dynamically extend into the batch memory oool because 
argument 4 of the MEMPOOL directive is null. (2) The second, whose 
oool name is UV, occupies all memory remaining after the pools with 
explicit sizes have been allocated (because argument 6 is an 
asterisk)* pool because argument 7 is null. The second MEMPOOL 
directive defines a nonexclusive online memory oool area named AX, 

It can dynamically extend (if necessary) into the batch memory oool 
(argument 4 is X, indicating rollout). 

The diagram below (not drawn to scale) indicates the memory pools 
established by the MEMPOOL directives in examples 1 through 4, Mote 
that the two sets of nonexclusive online memory pools define the 
same ohysical area of memory. 
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Example 5* 


MEMPOQL E , JJ , 4096, PCUSX, RR, 8 000 , SU 

This example defines two memory pools! one named JJ, the other PR, 
Both pools are exclusive. The attributes for pool JJ ere designated 
by the two arguments that follow the entry JJ. The first designates 
a size of 4096 words. The second specifies that the pool is 
protected, contained, and unprtviledged, that only one grouo can use 
it at a time (serial usage), and that It can extend into the batch 
pool area. Note that the elements of this argument can be entered in 
any order, and that no commas are inserted between elements. 

Pool RR is assigned 8000 words of memory. It is neither protected, 
nor contained, nor expandable! it is unoriviledged and reouires 
serial usage. 

Example 6t 

MEMPCXJL E, CK,4000,PS 


MEMPOOL E, f JL,XK, ,MM,KK 

This example illustrates the use of the renames ootion. Pool fCK is 
declared first. The second directive specifies alternate names for 
this pool. Pools LL and MM hav* the same attributes as KK. Both are 
protected since KK is protected. All three names define the same 
4 000-word area in memory. Since KK is serial usage, LL and *<M are 
serial usage also. The serial usage attribute is a function of the 
pool name. Since these three pool names describe the same memory 
oool, three grouos can possibly use the pool area LL, and a grouo 
using MM could all be active at the same time. But, for examole, 
two groups using the pool name KK could not ooth be active at the 
sains time. 
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QUIT PIRECTIVB 

* 

Directive Name* QUIT 

The QUIT directive must be the last directive in the file of CLM 
directives. 

Format * 


QUIT [VER1 


Argument Description* 

EVER] 

The VE3 argument causes the version (date and time created) of each 
Configuration Load Manager module used to be typed out at the 
operator terminal. The format of the tyoeout is shown below under 
the example. 


Punctional Description* 

The QUIT directive causes the Configuration Load Manager to cease 
reading CLM directives and to begin Its loading ohase. The following 
actions occur* 

I* Any required final data structures are created. 

2. If a communications environment has been defined, it is 
initialised. 

3. Sound units (If any) identified in LDBU directives are loaded 
into the system area of memory. 

4. System overlays (if any) identified in RESOLA directives are 
loaded into the system area of memory. 

5. Memory pool descriptors are created, based on the contents of 
MEMPOOL directives. Each memory pool set is checked to 
ascertain whether it can fit into available memory space. 

h. The Configuration Load Manager terminates* 
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example i 


QUI VER 


This example causes the Configuration Load Manager to cease 
CLM directives* type out the version Identifier of each CLM 
used* and enter its loading phase; The typeout might appear 
below. 


reading 
module 
as shown 


($5) 
CIS) 
($5) 
<$S) 
(IS) 
($S> 
($S) 
(IS) 
CIS) 
(IS) 
($S) 
(IS) 


CLMVAR 80/10/03/0036 
CLMST) 80/09/14/0903 
CLMST2 80/10/02/0808 
CLMDEV 80/10/10/1206 
CLMMMU 80/08/17/1021 
CLMCOM 80/11/08/1530 
CLMCM2 80/10/15/2105 
CLMCM1 80/10/15/2104 
CLMCM3 80/10/15/2106 
CLMCM4 80/10/15/2107 
CLMFLT 80/10/02/081 I 
CLM 80/09/21/0750 COMPLETED 
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RESOLA DIRECTIVE 


Directive Name* RESOLA 

The RESOLA directive identifies one or more system overlays that are 
to be loaded into the system area of memory, where they will remain 
resident for the duration of the configured system. 


RESOLA overiay^ameE .overlay.namel... 


Argument Description* 
overlay^name 

A string of up to six ASCII characters that Identify a system 
overlay that is to be made resident for the duration of the 
configured system. Appendix B identifies the system overlays that 
can be specified in this argument and the funtion(s) provided by 
each one. 


Functional Description* 

Each RESOLA directive adds one or more system overlay names to a 
list of resident system overlays. During the Configuration Load 
Manager's loading ohase, each name on the list is compared with a 
table of system overlay names. A match causes the indicated system 
overlay to be loaded Into tne system area of memory. 

If no match occurs* an error is indicated. If one o-verlay name on a 
RESoLA directive causes an error, ail other correctly specified 
overlays in the same directive can nevertheless be loaded.. 

Example* 

RESOLA OYDMT,OZTSUB,OZTUTL 

This example identifies three system overlays (these three are used 
for orocessing magnetic taoe files) that will be loaded into the 
system area of memory, where they will remain resident for the 
duration of the configured system. 
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RLOCK DIRECTIVE 


Directive Name* RLOCK 

The RLOCK directive defines a pool of structures to be used by data 
management when record locking is requested at file reservation 
time* The size of the pool determines the total number of records 
that may be locked at one time. 

One structure is used for each record to be locked. The size of each 
structure is six words for SAF and eight words for LAF. These 
structures are reusable after records become unlocked. The RLOCK 
directive must be included if the record lock facility is to be 
used. If more than one RLOCK directive is given, the last one takes 
eff ec t. 


Forma t * 

RLOCK Unit!,Unci,Unaxl 


Argument Description* 

Unit] 

Specifies the number of initial record lock structures. The default 
is 15. 

I incl 

Specifies the number of record lock structures that can be added at 
one time. The default is 5. 

CmaxI 

Specifies the total number of record lock structures permitted. The 
default is 30. An entry of 0 signifies that the total number of lock 
structures is unlimited. If the initial size or the increment size 
is greater than the maximum size, the following CLM message is 
generated. 

I33A RLOCK ARGUMENTS INCONSISTENT WITH EACH OTHER 
NOTES* 

1. The initial record lock pool is allocated in system memory 
at the time of the first record lock request. 

2. The sizes of all three arguments are rounded up so that 
the amount of a memory allocated is a multiple of 32 words 
minus 2 for SAF, or 32 words minus 3 for LAF. 
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Functional Description! 


The record lock facility of the file system provides multi-user 
interferance protection for records within shared disk files. For a 
detailed description of this facility s-ee the Data File 
Organizations and Formats manual. This facility requires that a 
pool or record lock structures be created by means of .the RLOCK 
directive. Because record lock entries are used and surrendered 
dynamically* the RLOCK oooi need contain only enough entries to 
service the maximum number of records that will be locked at the 
same time* The following procedure shows how to calculate the size 
of the record lock pool for a system where a number of users perform 
simultaneous transactions* 

Assume that each transaction consists of an uDdate of three records. 
The file system will lock the control intervals (Cl's) in which the 
three records reside* and for Indexed sequential files it will also 
lock the record oreceding each of the accessed records! Thus, a 
maxinum of six Cl's may be locked. However* two consecutive records 
are usually in the same CIi therefore three locked Cl's is a good 
approximation for an indexed sequential file and the exact value for 
other file organizations. 

Assume that ten users perform transactions but never more than four 
users access the data base simultaneously. For these assumptions* 
the initial number^of record locks is 12 (4 x 3) and the natural 
increment is 3. 

The accuracy of these estimates may be improved by taking into 
account the memory management features. Record lock entries are 
allocated in system memory* and system memory is obtained in blocks. 
(A multiple of 32 minus 2 words for SAF* a multiple of 32 minus 3 
words for LAF). In a SAF environment* record lock entries are six 
words long. Therefore, for SAF, better estimates for Initial and 
increment values would be IS and 5. 

Example I * RLOCK 

init - 15 
inc * 5 
max * 30 

Example 2* RLOCK ,,45 

init * 15 
inc * 5 
max * 45 

Example 3* RLOCK 45**45 

init * 45 
inc * 5 

max * 45 Error becausa 45+5>45 
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RLOCK 




BLOCK 


example 4* RLOCK 45,0,45 

Init * 45 
Inc * 0 

max * 45 No error 

Example 5* RLOCK 20,5,60 
RLOCK ,4 

init * 15 
ine » 4 

max * 30 Because the last RLOCK 

directive is the effective 
one. 

Example 6» RLOCK 20,5,60 
RLOCK 20,4,60 

init * 20 
ine « 4 
max * 60 

Example 7t RLOCK ,,0 

init * 15 
ine * 5 

max * unlimited 
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SYS DIRECTIVE 


SYS 


Directive Kane* SYS 

The SYS directive defines a number of system variables. 


Forma t * 


SYS CHzMscan-cycie] 


SSIP\ 
, DSIPJ 
< CIP } 
SCIPl 
null J 


ColanJ ,Ctsal*Clrb]C ,,E1 


Argument Descriptions* 


C Hz 1 


Specifies the line frequency at which the system's realtime clock 
operates. Possible values are 60 (for 60 Hz) and 50 (for 50Hz). 
Model 20's and 30's should be configured with a value of 50 if the 
line frequency is 50 Hz. and 60 if the line frequency is 60 Hz. 
Model 40's and 50's should always be configured with a value of 60. 
The default value is 60 (the U.S. standard). 


C scan_cycle) 

Specifies the time, in milliseconds, between interrupts by the 
system's real-time clock. The default value is 50 (milliseconds). 

The following values (in milliseconds) are possible for scan_cycle. 


50 Hz Line 

10 

20 

50 

100 


60 Hz Line 

S 

t6 

23 

33 

50 

100 


Millisecond intervals in c/clic clock request blocks should be 
expressed (if possible) in multiples of the scan_cycle. This 
practice ensures long-term accuracy of event synchchronization. 
Otherwise, the full deviation between the specified interval and the 
nearest sean_cycle multiple Is always realized. 
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05 

-< 

05 


Specifles\that scientific instructions and/or commercial 
instructions will be used in applications. Commercial instructions 
are processed by the Model 47 or Model 57 Central Processor in 
eonfigurations so equiooedt otherwise, commercial instructions are 
processed by a software simulator (CIPSIM). Scientific instructions 
are processed by the Scientific Instruction Processor if it is 
present* otherwise, scientific instructions are processed by the 
software simulator (SIPSIM). 

Note that in configurations with a Model 47 or Model 57 Central 
Processor, the commercial extension to the interrupt save area is 
automatically created for each oriority level except for those 
specified for this argument. The presence of a hardware Scientific 
Instruction Processor automatically creates the commercial and 
scientific extensions to the interrupt save area for each priority 
level exceot for those levels occupied by drivers, regardless of the 
option specified for this argument. 

SSIP indicates that single-orecis ion scientific instructions are to 
be processed. If the hardware Scientific Instruction Processor is 
not present, the single-precision SIP simulator <SIPSIM_SP) will 
automatically be loaded during the system startup. If the hardware 
Scientific Instruction Processor is present, it is used and the 
single-precision SIP simulator Is not loaded. (SSIP is permissible 
for use with BES 2xx FORTRAN programs and FORTRAN programs without 
double precision). 

DSIP indicates that double-orecision scientific instructions are to 
be processed. If the hardware Scientific Instruction Processor is 
not present, the double-precision SIP simulator (SIPSIM) will 
automatically be loaded during system startup. If the hardware 
Scientific Instruction Processor i£ present, it will be used and the 
double-precision SIP simulator is not loaded. (DSIP is oermissible 
for BES 203 — and later — FORTRAN orograms). 

CIP indicates that commercial instructions are to be orocessed. If 
the required central processor model Is not oresent, you must 
include an LDBU directive that identifies the commercial simulator 
(CIPSIM). If the required central processor model oresent, it 
will be used and the Commercial simulator should not be identified 
in an LDBU directive. 

SCIP indicates that both scientific and commercial instructions are 
to be processed. If the hardware Scientific Instruction Processor is 
not present, you must include an LDBU directive that identifies the 
single-precision SIP simulator (SIPSIM_SP) or the double-precision 
SIP simulator (SIPSIM). If a Commercial Central Processor model is 
not present, you must Include an LDBU directive that Identifies the 
Commercial simulator (CIPSIM). If the hardware Scientific 
Instruction Processor and a commercial central orocessor are 


i ssrp \ 

DSIP , 
CIP > 
SCIP 1 
null j 
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present, they will be used and the Sit 3 and commercial simulators 
should not be identified in LD8U directives. 

NOTH* If both 5IP and commercial simulators are used, the order of 
the LDSU directives governs the order in which the simulators 
process a trap to the single trap vector they share. The 
simulator identified in the last L03U directive will process 
the trap first . 

null (no entry) indicates that no scientific or commercial 
instructions are to be processed 2T that any reouired hardware 
Scientific Instruction Processor and/or a commercial central 
orocessor model is present and will be used. (Thus the corresponding 
simulator is not used>. 

tolanJ 

Specifies the number of 512-word sysytem overlay areas to be 
created. The value for olan must be a decimal integer from 2 
through 99. The default value is I, indicating one 512-word area to 
be used for system overlays. 

C tsa 1 

Specifies the number of trap save areas to be created in addition to 
the default number of 6 (system without communications) , 7 (L.AF 
system with communications), or 3 (SAr system with communications). 

The size of each additional trao save area is the same as the size 
of each of the default trap save areas (viz., 64 words in a SAF 
system and 104 words in a LAF system). 

You have the option of expressing this parameter symbolically by 
defining it with a VARIABLE directive. See the description of the 
VARIABLE directive elsewhere in this section. 

C irbJ 

Specifies the number of intermediate request blocks to the created 
In addition to the default number of 20 for the system. Each 
intermediate request block is 3 words in a SAr system and 13 words 
in a LAF system. 

You have the ootion of expressing this parameter symbolically by 
defining it with a VARIABLE directive. See description of the 
VARIABLE directive elsewhere in this section. 
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CO IEJ 

(fl Specifies that expanded error messages (text in addition to code) 
are to be issued. If this argument is omitted, only the error code 
is issued. 

Once this argument is specified, it remains in effect for the 
duration of the configured system, even If subsequent SYS directives 
aopear with this argument null. 

This argument is not meaningful if the system is bootstraoped from 
diskette! space limitations on diskette prevent the presence of the 
error message library file (EMLFILE)* 


runctional Description* 

The SYS directive defines a number of system variables. If all of 
the SYS directive's default values are acceptable, it can be 
omitted. These default values are summarized below. 

Hz - (SO Hz line frequency 

scan„cyele - 50 milliseconds 

3SIP/DSIP/CIP/SCIP - null (no SIP simulator or commercial 

simulator required) 

olan - I system overlay area 

tsa - 7 trap save areas 

irb * 20 intermediate reauest blocks 

£ * error code only, no text 

If multiple SYS directives are specified, only the last one is 
effective! exceotions* Cl) all trap save areas and intermediate 
request blocks specified on all SYS directives are added to the 
system defaults of 7 and 20, respectively, and (2) if E is soecified 
in any SYS directive, expanded error messages (text in addition to 
code) will be issued. 

The size of the interrupt save area (and hence the size of the task 
control block, which includes the interrupt save area) depends on 
the CPU Model and SIP/CIP characteristics as shown in Table 5-9. 
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Table 5-9. Decision Table for Calculating TC8 Size, Based on CPU 

Model and SIP/CIP Characteristics 



Conditions* 

Model 23# 33# or 6/34 

*©<!• I 43# 47# 33# 
or 37 P 

SIP hrrdwir* present? 

Model 47 or 37 

Hull iC4UP*lt7 

S8XP ergw**nt7 

D61P ergunent? 

CIP orgunent? 

SCIP ergunent? 

Seoultent ISA Type* 

Sonic ISA 

a Model 40 ond 30 
register* 

+ CIP context 

+ SIP context 





TCB Size# aosed 

on ISA Type 


ISA Type 

SAP Size 
(words) 

UP Size 
(words) 

Basic ISA 

44 

Not eppiicsble 

> Registers 

44 

94 

+ CIP Context 

9f 

94 

* SIP Context 

46 

12S 


NOTES* 1* Entry noonings* ¥ - ye* M - no x * ISA type 

2* The besic ISA ends with the Reregister sowe word* 

3* The ISA for node! 43# 47# 33# or S7 register* include* the besic ISA# sewe words for the 
NX* through N7-regixterx# end save werd(e) for the stock oddres* register, 

4* The CIP context Includes oil elements in lt*» 2/ plus the ClP-speclfic context area of 
2 words (SAP) or 3 word* (LAP)* 

3. The SIP context Includes ell elements in iten 3# plus the SlP-epecitlc context ores of 
13 words* 

6* All TCB sizes ore rounded up to the nee rest eultiple of 32 words. 
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SYS 


Example * 


SYS ,25,SSIP,5 *««'E 

This example defines the system variables as shown below, (Assume 
that only one SYS directive is used), 

. The system line frequency is 60 Hz (default), 

. The scan-cycle of the systems real-time clock is 25 
miliseconds. 

. The single-precision SIP simulator (SIP5IM„SP) will be loaded 
to process scientific instructions„ unless the hardware 
Scientific Instruction Processor is present. 

, rive system overlay areas will be created. 

. Six trap save areas will be created (default if no 
communications). 

. Twenty Intermediate request blocks will be created (default). 

. Error codes will be expanded to include message text. 



VARIABLE 


VARIABLE DIRECTIVE 
Directive Name* VARIABLE 

The VARIABLE directive defines a single-character symbolic 
expression (chosen from the letters A through 2) that may be 
specified in certain CLM directive statements. 

Variables can define values for the fields in the SYS directive 
representing additional trap save areas or Intermediate request 
blocks, or memory pool sizes in a MEMPOOL directive. A variable must 
be defined by a VARIABLE directive before it can be specified in 
other CLM directives. 


rormat * 

VARIABLE varlable*express ion 


Argument Description* 
variable 

A single character designation* upper case only, chosen from the 
letters A through 2. 

expression 

Any valid expression that defines the value of the variable. 
Expression may equal any of the following* 

. An integer having a value between - 32 747 and +32747. 

. KSR (represents the total number of MDC-connected terminals 
finally configured using the KSR value) 

. CON (represents the total number of MDC-connected terminals 
finally configured with the CON value) 

. TTY (represents the total number of communications devices 
finally configured by DEVICE TTY directives) 

. VIP (represents the total number of communications devices 
finally configured by DEVICE VIP directives) 

. AID (Represents the total number of devices finally configured 
by DEVICE ATD directives) 
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VARIABLE 


♦ expression ) - 

. ' b 

An arithmetic combination of two expressions (chosen from this 
list) using addition ( + >, subtraction (-), multiplication (★> 
or division (/), The value of an expression is always an 
integer! all fractional values are truncated, not rounded. For 
example, 5/3 will be passed to the system as having a value of 
one (l), 

c (expresion (1)) 

expression, is to be evaluated before being combined with any 
other expression term. The expression is always evaluated by 
the system as an integer! all fractional values are truncated, 
not rounded. For example, 5/3 will be passed to the system as 
having a value of 1. At each step of the evaluation of an 
expression, fractional values are truncated, l.e., this is 
strictly integer arithmetic. 


expression 


*)*( expression 


Specifies a signed value, plus or minus, for the expression. 
Note that "♦expression'" has the same value as "expression 11 . 

• x (where x is the name of an already defined variable) 

Variables may,be used when specifying the number of trap save areas 
and intermediate request blocks in a SYS directive, or the size of a 
memory pool in a MEMRiXJL directive. Using a VARIABLE directive, you 
ean assign symbolic values for these fields that will be 
subsequently resolved by the system. By specifying variables in SYS 
or MEMPtXJL directives, the system builder creates a generalized CLM 
file that may be used by several similar but not Identical hardware 
configurations. 

Example It 


VARIABLE A*TIY*3000 
MEMP.(X)L ,T1 ,A 
MEMP(X)L S,,* 


Note that In all cases, a variable must be defined in the CLM file 
before it can be used in subsequent directives. The variable A has 
been defined to be equal to the total number of TTY terminals 
finally configured, multiplied by 3000. In the MEMP(X)L directive, A 
represents the 3000 words of memory that will be reserved for each 
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TTY configured! The first VEMPOOL directive defines the name and 
size of the memory pool that has reserved 3Q00 words of memory for 
each TTY terminal* The second MEMPOOL directive allocates all 
remaining memory to the system memory pool* 

By defining memory pools with variables* the system builder can 
accurately account for as many or as few devices as are actually 
configured. He need not know the channel number assigned to each 
device, the memory pool size, or the number of devices actually 
configured. The system assigns these characteristics accurately and 
automatically. 

example 2* 


VARIABLE B=TTY*3 
VARIABLE C»TTY*2 
SYS ,,,,C,B 


In this example, two variables have been defined for the trap save 
area and intermediate request block fields in the SYS directive. C 
Is defined as the number of trap save areas that will be allocated 
for each TTY terminal, in addition to the default number. (The value 
of C equals twice the number of TTY terminal's configured). C 
specifies that each terminal will have twp trap save areas in 
addition to the default number. B is defined in the SYS directive as 
the number of Intermediate request blocks that will be allocated for 
each TTY terminal, in addition to the default number. (The value of 
6 equals three times the number of TTY terminals configured). B 
specifies that each terminal will have 3 intermediate request blocks 
in addition to the default number. 
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VARIABLE 


Sample CLM File 


Example 3* 



2 

3 

4 


VARIABLE T“TTY+VIP 
VARIABLE I»KSR+IO 
SYS ,,,,I,T,,E 
DEVICE DSK00,6,10,X'400 
DEVICE DSKOt,7,J1,0 
DEVICE rCD00,8,12,0 
DEVICE RCDOO t 9,12,0 
COMM 13 


r DEVICE TTYOI,J 4,14,0 
DEVICE TTY02,I 5,15,0 
DEVICE TTY03.16.14.0 


{ 


DEVICE TTY04,17,17,0 
TTY 14,14,0,0,300 
TTY 15,15,0,0,300 
TTY 16,15,0,0,300 
TTY 17,17,0,0,300 
VARIABLE Z=TTY*500 
MEMPfXJL ,LO,Z 
MEMPOOL S,,* 

QUIT 




Example 3 Comments* 


I, Variable T and I have been defined in VARIABLE directives 
replacing constant values in the SYS directive! T equals the 
total number of TTY and VIP terminals configured. I equals 10 
plus the number of KSR terminals configured. In the SYS 
directive, T replaces some constant value in the intermediate 
request block field. In this context. T specifies one 
additional trap save area for each TTY or VIP configured* I 
specifies that the number of additional intermediate request 
blocks equal JO more than the number of KSR terminals 
configured. 


. 2. A maximum of four TTY terminals may be configured depending 
on the number of available channels (with asynchronous line 
adapters). All terminals have floating channel assignments 
and are configured in the order in which they appear in the 
CLM file. 


. 3. The variable Z is defined such that 500 words of memory are 
allocated for each configured TTY terminal). (Z equals 500 
times the number of configured TTY terminals). In the MEMPOOL 
directive that follows. Z specifies that oool LO allocates 500 
words of memory for each TTY configured. The size of pool LO 
could be 500, 1000, 1500, or 2000 words, deoending on the 
final number of TTY temlnals actually configured. 

4. This MEMPCXJL directive allocates all unreserved memory to the 
system memory pool. 


x -!,■ !i r - v V 'x 
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SECTION VI 

CLM DIRECTIVES FOR A COMMUNICATIONS CONFIGURATION 


This section describes the CLM directives used to define the 
communications environment of the system software. Communications 
CLM directives may be entered from the CLM_.USER file or from any 
file or device specified in a CLMIN directive. There after, a system 
startup can be performed. 

If your Installation Includes communications (MLCP/DLCP-connected) 
devices, you should have the Communications Processing manual 
available for reference. 

The communications-related CLM directives cause the following 
functions to be performed* 

. Data structures (l.e., tables) are established corresponding to 
the communications hardware available to your system. 

. The following bound units are loaded Into the central 
processor's main memory* 

- Communications supervisor and multiline/dual line 
communications processor (MLCP/DLCP) driver. 

- One or more line protocol handlers (l.e., TTY, VIP, ACTD, 

ATD, STD, BSC, PVE, HASP, RCI, or user-written). 

. The following elements are loaded into the RAM (random access 
memory) of one or more Communications controllers* 

- Data set channel control program. 

- Channel control programs of one or more line protocol, 
handlers• 

Table A-l summarizes the communications-related CLM directives, 
which are described In alphabetic order in this section. Table 6-2 
provides detailed Information on physical devices suoported by 
various directives. 
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Table 6-1 * Summary of Communications—Related CLM Directives 


Directive 

ACID 

ACU 

AID a,b,c 

BSC 

COMM 

DEVICE 

EQLRN 

HASP 

H3270 

LPHn 

LPHDEP 

MODEM 
POLIST 

PVE 


Meaning 


Identifies a station on a line serviced by the 
Asynchronous Character Terminal Driver. 

Defines an Auto Cali Unit and associates thfe ACU channel 
with a data communications channel, optionally, provides 
one or more telephone numbers to be used in establishing 
a connection for the associated data communications 
channel. 

Identifies a station on a line serviced by the 
asynchronous terminal device (ATD) line protocol 
handler. 

Identifies a station on a line serviced by the BSC 
(binary synchronous communications) line protocol 
handler. 

Establishes the priority level(s) at which the MLCP/DLCP 
interrupts the central orocessor. 

Indicates that the designated communications station is 
to be accessible through the file system interface. 

Defines multiple logical resource numbers (lrn's) for 
the same ohysical communications device. 

Identifies a remote workstation serviced by the HASP 
protocol* 

Identifies a station on a line serviced by the BSC 3270 
protocol. 

Identifies the first (or only) station on a line 
serviced by a user-written line protocol handler. 

Indicates nonstandard table sizes for channels and 
stations controlled by a user—written line protocol 
handler. 

Defines a nonstandard modem type. 

Identifies the start of the pool list on a line serviced 
by the synchronous terminal device line orotocoi 
handler. The line is identified by a STDLN directive. 

Identifies a polled VIP emulator "station 14 on a line 
serviced by the VIP line protocol handler. 






























Table 6-1 (Cont). Summary of Communications-Related CLM Directives 


Directive ! 

Meaning 

RCI 

i 

Identifies a remote batch terminal serviced by the RCI 
protocol. 

ROP 

Indicates that a receive-only printer Is connected to a 
station on a line serviced by the synchronous terminal 
device line protocol handler. The line is identified by 
an'STDLN directive and the station is identified by an 
STD directive. 

STAPOL j 

| 

i 

Defines a sequence of station poll addresses to be added 
to the poll list of a line serviced by the synchronous 
terminal device (STD) line protocol handler. The line is 
identified by an'STDLN directive. 

STD d 

Identifies a station on a line serviced by the 
synchronous terminal device (STD) line protocol handler. 
The line Is identified by an STDLN directive. 

STDLN d 

Identifies a line serviced by the synchronous terminal 
device (STD line protocol handler. 

STATION 

Identifies the second or subsequent station on a line 
serviced by a user-written line Drotocol handler. 

STTY 

Specifies the file characteristics of a device that is 
not a disk device or a unit-record device. 

TTY c 

Identifies a station on a line serviced by the TTY 
(teleprinter) line protocol orinter. 

VDAM 

Incorporates the Display Formatting and Control software 
component in the configuration. 

V IP d 

Identifies a polled or nonpolled synchronous visual 
Information projection (VIP) terminal on a line serviced 
by the VIP line protocol handler. Optionally, Identifies 
an ROP (receive-only printer) station on the same line. 

7Rosy a 

Identifies a PRUIOGI/1003/1005 device on a line serviced 
by the ATD line protocol handler. 
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Table 6-1 (Cont). Summary of Communications-Related CLM directives 


r 


Direct!ve 
'VTTY a 


V7200 a,t> 


Meaning 


Identifies a teletype-like device on a line serviced by 
the AID line protocol handler. 


Identifies a VIP7200 or VIP7205 device on a line 
serviced by the ATD line protocol handler. 



The ATD directive is intended as a replacement for the VROSY, VTTY, 
and V7200 directives; The protocol handler called by the ATD 
directive offers additional support capabilities e.g., block mode 
support of VIP7801/Q2 devices* support of the VIP7207 device) not 
offered by the line protocol handler called by the VROSY, VTTY* and 
V7200 directives. The VROSY, VTTY, and V7200 directives can still 
be used. 


The ATD directive or the V7200 directive must be specified if 
VIP7200 or VIP790I/02 terminals are to be used for forms processing 
usin^ CII HONEYWELL BULL Display Formatting and Control Facility. 


c 

The TTY directive and the'ATD directive suoport asynchronous 
terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only in teleprinter mode. 
The TTY line.protocol handler does not provide block mode suoport 
of VIP7801/02 devices* neither does it provide support for VIP7200 
devices and VIP780I/02 devices In forms processing mode. {For these 
functions the ATD directive is required). ATD line protocol 
handler does not provide the transparent I/O or single character 
mode functions of the TTY line protocol handler. 


d 

The STD directive and the VIP directive support synchronous 
terminal devices. The line protocol handler called by the STD 
directive offers additional suoport capabilities (e.g., line 
protocol handler called b/ the VIP directive. 
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Table 6-2# CLM Directives and Supported Communications Devices 


Directive 

Devices Supported 

AC TO 

vrp 7200 

DKXJ 7001 

DKU7002 + auxiliary badge 

+ auxiliary printer 

ATO 

VIP 7200 

VI? 7205 

VIP 780) 

VIP 7802 PRU 1001/1003/1005 

T/IU 1001/1003/1005 

Receive-only printers* 

PRU 1001/1003/1005 

3SC 

Level 6 central processor 

HASP 

IBM central orocessor 

H3270 

IBM central processor 

PVS 

Level 6 central processor 

HCI 

Level 6 central processor 

STD 

. VIP 7700 VIP 7700R 

VIP 7705R VIP 7760 

VIP 7804 VIP 7805 

Receive-only printers* 

TN 300 

TNI 200 

PRU 1003/1005 

TTY 

VIP 7100 VIP 7200 

VIP 7105 VIP 7205 

VIP 7801 VI? 7802 

TWIU 1001/1003/1005 

VIP 

VI? 7700 VIP 7700R 

VIP 7705R VIP 7760 

VI.P 7805 VIP 7804- 


Receive-only printers* 

TN 300 ASR-33 

' TN 1200 ASR—35 

PRU 1003/1005 

VROSY 

PRU 1001/1003/1005 
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Table 6-2 (Cont). CLM Directives and Supported Communications 

Devices 


Directive 

Devices Supoorted 

V7200 

VIP 7200 VIP 7801 

VIP 7205- VIP 7802 

VTTY 

ASR-33 KSR-33 

ASR-35 


You should observe the following rules for arranging 
communicatlons-related CLM directives * 

1. The COMM directive must precede all other 
communications—related CLM directives. 

2. If an LPHDEF directive is used in association with a 
user-written line protocol handler, the LPHDEF directive must 
precede all related LPHn directives. 

3. If STATION directives are used in association with an LPHn 
directive (In cases where a user-written line protocol handler 
drives more than one station per line), the'STATION directives 
must immediately follow the related LPHn directive. 

4. The DEVICE directive should follow related LPHDEF, STATION, 
and LPHn directives and related POLIST, STAPOL, ROP,'STDLN, 
and STD.direct!ves. 

5. If an ACU directive is used, the station whose Irn apoears as 
an argument in the ACU directive must be defined in the 
directive that immediately precedes this ACU directive. 

6* When polled VIP-'s are connected to a communications line, the 
VI? directives for the stations on the line must be 
consecutive. 

7. When polled VIP emulator (PVE) stations are associated with a 
communications line, the PVE directives for all the stations 
on the line must be consecutive. 

8. The value assigned to the communications interrupt level (by 
the COMM directive) Is normally restricted to the range 7 
through 57. At initial startup, the bootstrap device, is 
assigned level 6 by the system. If the level assigned to the 
bootstrap device is changed to a lower level (higher number) 
by a DEVICE directive, the communications interrupt level can 
be specified as 6. The level that Is assigned to a 
communications device associated with a COMM directive is 
normally 8 through 58. 

9. When an MLCP/DLCP operator console Is configured, it must be 
assigned LRN 0. 



10. Configuring a line serviced by the STD line protocol handler 
requires at least the directives STDLN, STD, P0L1ST, and 
STAPOL. An STD line may also use a RO? directive. The 
following diagram illustrates sequence rules for STD 
directives. Brackets enclose optional directives. One set of 
these directives must be specified for each line* 

STDLM must specify one for each line 

STD 1 

CROP! specify one for each lsoecify one set for each 
station, If needed (station on the line* ail 

) must precede POLIST 

STD 2 
CROP] 


* 

POLIST must specify one for each line 

STAPOL must soeeify one or more for 
each line* all STAPOL 
directives should be specified 
in the order in which stations 
are to be polled 

(DEVICE] (optional) specifies that the device will be 
accessible to the file system 

It. As a general rule, two line protocol handlers are allowed per 
MLCP/QLCP. 

12. The STTY command keyword format, as described immediately 
following the STTY directive, may be used as an alternative to 
the STTY directive format in your CLM file. The STTY comm and 
format provides additional features not supported by the STTY 
directive format. For example, if you wish to specify a 
terminal as being automatically reconnectable following a 
power failure or line drop, you must configure the terminal 
using the STTY command format in your CLM file. (For a 
complete description of this capability, see Appendix D>• 

13. Each directive for a communications device must reference a 
unique logical resource number (lrn). If you wish to specify 
multiple communications directives which reference the same 
physical device, you should use the EQLRN directive. The EQLRN 
Jirective is described later in this section. 
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TOPICS RELATED TO COMMUNICATIONS DIRECTIVES 


The following paragraphs describes 

. How to assign channel numbers to your communications devices* 
or* how to let the system dynamically assign channel numbers 

• How to modify a terminal's line length 

• How to let the system dynamically assign a terminal's line 
spaed 

. The amount of resident code required for communications 
modules. 

fou should review each of these topics before you create your CLM 
directive file. 


Assigning Channel Numbers 


Channel control programs are loaded Into the MLCP on the basis of 
channel numbers you specify for communications devices. You should 
observe the following guidelines when assigning channel numbers to 
your communications devices* 


a. As a general rule* no more than two line protocol handlers can 
be associated with a given MLCP* 


b. The MLCP with which a particular line protocol handler is 
associated is determined by the channel number(s) you enter 
for communications devices. The system checks the first six 
bits of the hexadecimal channel number you. specify to 
determine LPH allocation. 


This range of 
channel numbers 
specified for a 
device 


PCOO - FF80 
F800 - FB80 
F400 - F780 
FQOO - F380 
EC 00 - EF80 
+ 


causes the 
LPH to go 
into 


first MLCP 
second MLCP 
third MLCP 
fourth MLCP 
fifth MLCP 


c. Each channel number must be a 4-digit hexadecimal number 

ending in 00 or 80. Note that channel numbers lower then 0400 
are unavailable for communications devices. 
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DYNAMICALLY ASSIGNED CHANNEL NUMBERS 


For MLCP/DLCP-connectad devices, channel numbers may be dynamically 
assigned or "'floated' 1 In TTY, VIP, VROSY, VTTY, AID, V7200, or 
DEVICE directives* 

Assigning zero channel numbers to directives in the CLM file 
relieves the system builder of the need to know the channel 
assignments for each installation that will receive a copy of file 
system software. 

For each communications device configured, you have the option of 
specifying a channel number in the appropriate directive or allowing 
the system to dynamically assign or "float" channel assignments at 
startup time. To float a channel, you specify the channel number 
parameter in the appropriate directive with a single zero (0)* The 
system then assigns directives with floating channels to the first 
available devices on the bus* Note that if you specify a floating 
channel and the system cannot locate an appropriate device, no error 
message is issued* the system Ignores this directive. 

If your system Includes device adapters but not associated devices, 
it is recommended that explicit channel numbers be assigned to all 
devices within the device class* 

Channel numbers are assigned as soon as the first floating channel 
Is encountered in the CLM file. To prevent devices with floating 
channels from inadvertently preempting devices whose channel numbers 
are explicitly specified, ail directives of a given type with 
explicitly specified channel numbers should orecede all directives 
of that tyoe with floating channels in the CLM file. All active 
channels should have higher bus addresses than ail active channels 
to prevent the system fom inadvertently assigning a device to an 
inactive channel. 

For KLCP/DLCP-connected devices, the first available channel with 
the highest bus addreas and appropriate channel adapter 
(asynchronous or synchronous) will be assigned to the first 
floatable channel in a communications directive, and so on. 

NOTE* Assigning floatable channels to communications devices is 

recommended only if all devices will be configured identically 
(if, for example, a system specifies that all asynchronous 
devices will he directly-connected VIP 7200- / s with identical 
line speeds, DEL characters, stop bits, and parity). The- 
system cannot distinguish between different types of 
MLCP/DLCP-connected devices.<1) 


( t) 

The M4—SYSDEF program does not permit you to configure MLCP/DLCP 
connected devices with floating channel numbers, M4_SYSDEF requires 
the system builder to suoply all channel numbers for communications 
devices. 
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If a system Is configured with devices containing floatable channel 
numbers, the system, builder may determine all channel numbers 
assigned by the system as soon as possible after a system 
initialization. The system operator can issue the command STS -ALL 
to list each device and its channel number assignment. 

See Section V for an example illustrating the use of floating 
channel number assignments* 


Modifying T e rmina l Line Length 


The line length specified for a terminal or other input device at 
system building time overrides the command processor line length of 
127 characters. For example, at terminal configured with a line 
length of 80 characters, you cannot enter a continuous command line 
longer than 80 characters unless you type an ampersand (&) at the 
end of the line and then continue on one or more additional lines. 
You can alter the ter minals line length by using the set terminal 
characteristics CSTTY) command (described elsewh ere in this manual) 
after system initialization or by modifying the STTY directive in 
your CLM file. 


Terminal 
(TnTyl- 


Line Speed Selection Capability (Asynchronous Terminals 


When you specify an ATD, TTY, LPHn, VTTY, or V7200 directive, you 
have the option of deferring selection of an asynchronous terminal's 
line speed (specified by the fifth parameter) until the terminal 
comes online (I). To defer selection of a terminal's line speed, you 
specify the fifth parameter as either M HI W or "L0" in one of the 
above-mentioned directives. Choosing this option frees you from 
specifying an exact line speed for every asynchronous terminal in 
your configurations The interactive system building program, 
M4_SfSDEF, incorporates this deferred speed selection capability. 

In order to allow the system to determine the terminal's line speed, 
the operator presses the RETURN key on the terminal's keyboard when 
the terminal comes online. If, after several seconds, normal 
terminal operations have not begun, the operator should check for 
one of the following problems * 


( I) 

If you choose this option, an Auto Call Unit must not be configured 
for the terminal. 
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1. The terminal/s line speed may not be within the range 
specified in the appropriate CLM directive. The.operator may 
be able to adjust the terminal's line speed to fall within the 
range specified by the directive. The operator should then 
pre^s the RETURN key. If, however, the terminal's line speed 
is fixed, adjustments must be made to the appropriate CLM 
directive. You may be required to change the designation of 
the terminal's line speed in the appropriate CLM directive. 

2. If the carriage return character was garbled and the system 

could not determine the line speed of the terminal, the 
operator should press the RETURN key again. _ 

3. If the terminal's modem has gone offline, the operator must 
dial up the line again. 

If the system fails to receive a character transmission within ^0 
seconds, the terminal will be disconnected. 


Resident Code Requirements for Cownunlcations Modules 


The following table defines the number of words of resident code 
required for various communications modules! the table also list the 
memory required in the MLCP/DLCP for associated channel control 
programs (CCP's). Memory requirements for noncommunications modules 
are defined in Section V. 
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Table 6-3. Communlcations Memory Requirements 


i 

Component 

Resident 

Memory 

(SAP) 

(in words) 

Resident 
Memory 
; (LAP) 

; (in words) 

MLCP Memory 
Required for 
CCP (1) 

(In bytes) 

DLCP Memory ' 
Required for 
CCP (2) 

(in bytes) 

Comm Supervisor 

2* 4K 

2.5K 

N/A 

N/A 

i 

Autocall 

.4K 

c4K 

128 

206 

Speed select 

*2K 

«2K 

N/A 

N/A | 

TTY Line 

Protocol Handler 

I.7K 

U7K 

1429 

1772 ! 

VIP Line 

Protocol Handler 

2.4K 

2.5K 

1346 

1760 

BSC Line 

Protocol Handler 

2.6K 

2.6K 

11-00 EBCDIC 
870 ASCII 

1574 EBCDIC 
1126 ASCII - 

PVE Line 

Protocol Handler 

2.3K 

2.3K 

742 

1182 

RCI Line 

Protocol handler 

2.OK 

2.OK 

138 

235 1 

AID Line 

Protocol Hardier 

5.9K 

6.IK 

824 

1212 

ACID Line 
Protocol Hardier 

- 

5.3K 

1080 

- 

Auxiliary 

subsystems 

- 

0.15K 

- 

- 

Badge 

- 

Q.6K 

- 

- 

Printer 


.IK 

- 

- 


STD Line 

Protocol Handler 

3.6K 

3.5K 

800 

1226 

3270 Line 
Protocol Hardier 

2. IK 

2.IK 

I 158 

1758 

HASP 

6.8K 

7.2K 

232 

446 
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NOTE* Sizes do not include patch space sizes. Patch space is only 
required as patches are added, 

(I) 

2942 bytes of RAM memory are available in the MLCP for the loading 
of channel control programs. Any combination of the various CCP^s 
can be loaded into the MLCP provided the total memory does not 
exceed 2942 bytes. 

< 2 ) 

3844 bytes of RAM memory are available in the DLCP for the loading 
of channel programs. Any combination of the various CCP^s can be 
loaded into the DLCP provided the total memory does not exceed 3844 
bytes. 



ACID 


ACID 01 RECTI VE 


Directive Name* ACTD 

The ACTD directive Identifies a station on a line serviced by the 
asynchronous character terminel device line protocol handler* This 
directive is used when configuring stations of the following types* 

OKU 7002, DKU 7001, VIP 7200, VIP 7100 or TTY device. 

See Appendix. R to configure a station serviced by ACTD line protocol 
handler. 
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ACU 


ACU DIRECTIVE 


Directive Name* ACU 

The ACU directive identifies an Auto Call Unit and associates the 
ACU channel with a data communications channel! The ACU directive 
must immediately follow the directive describing the station whose 
lrn is specified in the ACU directive. The ACU directive cannot be 
associated with any data communications channel that supports the 
speed select option. 

The ACU directive permits the addition of telephone numbers to a 
list of numbers maintained for a data communications channel! The 
list of telephone numbers for a data communications channel can be 
unlimited and has the following format* 

Entry 0 empty (initially) 

(Entry 1 phone_number t1 

(Entry 2 ohone„number 2J 

(etc.J 

The Auto Call Unit dials each number in the list three times at 
40-second intervals until the list Is exhausted or a connection Is 
made. 

The first ACU directive that relates an Auto Call Unit to this data 
communications channel causes an empty entry 0 to be established* 
this entry in the list may be loaded and reloaded, as desired, by 
means of an SDL (set ACU telephone number) command or sSDL macro 
call. The first ACU directive also creates an entry In the table 
(starting with entry I) for each telephone number (if any) specified 
in the directive. Any subsequent ACU directive relating the same ACU 
to the same data communications channel causes one or more 
additional entries to be added to the list* the additional entries 
are added to the end of the list in the order in which the teleohone 
numbers appear in the ACU directive. 


Format * 

ACU lrn, level,X^acu_channel'( y phone_#I' C ,'phone_i(*2^ t, •.. 1 J J 
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3 Argument Desctiption* 

a , 

^ lrn 

The logical resource number of any station on the data 
communications channel with which this Auto Call Unit is associated, 

level 

The priority level of the station whose lrn aopears in the lrn 
argument of this directive, 

X-'acu.channel' 

A 4_dig.it hexadecimal number (from X'4.0O' to X'FFSO') specifying the 
channel number of the Auto Call Unit, 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 15 - Must be set to zero. 

[■'phone^n* 3 

A string of 1 to 16 ASCII characters chosen from the set 0 I 2 3 4 5 
6 7 8 9 - (separator) * #. 


FUNCTIONAL DESCRIPTION* 

n ACU directive causes the Auto Call Unit to initiate a line 
connection with a remote auto answer data set, When the software 
issues a connect order and bit 2 of the IORB is set to one, the Auto 
Call Unit attempts to dial a line using the list of telephone 
numbers established at configuration time. The Auto Call Unit dials 
each number In the list three times at 40-second intervals until a 
connection is made or the list is exhausted. 

cxamp le • 

TTY 26,8,X'FCOO* 

ACU 26,8,X'FDOO ',* 1-555-240-0231* 

In this example, an Auto Call Unit on channel FDOO is associated 
with the data communications channel (rCOO) servicing a TTY whose 
logical resource number is 26 and whose priority level is 8. Since 
this is the first ACU directive for this Auto Call Unit, the 
telephone number in the ACU directive is established as entry 1 in 
the list of telephone numbers for the indicated data communications 
channel (FCOO). Note that the ACU directive immediately follows the 
TTY directive that describes the station whose lrn appears in the 
ACU directive. 



ATD 


AID DIRECTIVE 


Directive Marne* AID 

The'ATD directive Identifies a station on a line serviced by the 
asynchronous terminal device iine protocol handler. This directive 
is used to configure asynchronous terminals as part of the 
communications system: The ATD directives must follows the COMM 
directive in the CLM file. You. can float the channel number 
assignments in this directive, if you wish. 


Format* 

ATD lrn.level.X'channel'.tmodem],[speed 3,£'device-type'3 
[dell•tstop-bit](.parity] 


Argument Description* 
lrn 

The logical resource number associated with the station. The value 
for lrn Is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 

level 

* The priority level at which the ATS line protocol handler processes 
requests for an input/output operation to the station. The value for 
level is an Integer from 7 through 61* it may be the same as the 
level specified for other communications stations, but it must be a 
. higher number than the communications Interrupt level(s) specified 
in the COMM directive. 

X-'channel'' 

You may specify a single zero (0) to float this channel assignment 
or a four-digit hexadecimal number (from X-'tWOn' to X'FFBn'), that 
specifies the channel number of the station and the interrupt 
priority level (n) of the line! The channel number has the 
following format* 

- ..- 31ts 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14. and 15 - Specifies n, the priority level at which a 
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ATD 


communications line Interrupts the central 
processor, n may have a value of 0,1,2, or 3 as 
specified in the COMM directive. See the 
description of the COMM directive for further 
information. 


[modem) 

A number specifying the type of data set. Possible values are as 
follows * 

Q - Direct Connect. 

I - Bell ixx-type modem (103 A, etc.). Both data-set—ready and 

carrier-detect signals are reauired for a connection* absence of 
these signals is a disconnection. 

3 or greater - User—defined modem type (see M MODEM Directive, 41 

earlier in this section). 

The default value 1$ modem type 1. 

(speed) 

The data rate in bits per second. 

For an asynchronous line with a eommunicatlons-pac whose id is 
2108(16), use one of the following values for speed* 



50 

300 

— — y 

2400 

, 

75 

600 

3600 

(Default) 

110 

900 

4800 


134 

1200 

7200 


150 

1800 

9600 


For an asynchronous line with a communications—pac whose id (in 
hexadecimal notation) is 2100, 2110, or 2118, or 31)8, use one of 
the following values for speed* 



50 

200 

1800 


75 

300 

2000 

(Default) 

110 

600 

2400 


134 

1050 

4800 


ISO 

1200 

• 9600 


The deferred speed selection, option functions with the second 
set or adapter types only. 

NOTE* If the data rate is 134.5, specify 134. 

You have the option to defer selection of the line speed until the 
terminal comes online. You select this option by specifying HI or 
L0. 


I 


6-18 



'HI' 


Soecifies that all terminals associated with this line will be 
permitted to function only at speeds from 1200 through 9600 
bits per second. 


'L(K 


Specifies that all terminals associated with this line will be 
permitted to function only at speeds from 1)0 through 1200 bits 
per second. 

For more Information about the line speed selection capability, 
refer to the discussion under "Topics Related to CLM Directives" 
near the beginning of this section. 

['device-type'! 

Specifies the type of terminal used. If this argument Is not 
specified, the default Is TTY. Possible values are* 


Value 

Physical devices suooorted 

7200 

VIP 7200, VIP 

7205 


7801 

VIP 7801, VIP 

7802 


D7200 

VIP 7207 



PRU 

PRU 1001, PRU 
TrfU 1001 , TWU 

1003, PRU 
1003, TWU 

1005 

1005 

TTY 

An asynchronous terminal 
that is to be supported 
teleprinter-compatible 

as 

TN300 

Terminet 300, 

PRU 1004 



[del I 

In TTY mode, a head-of-form sequence (pre—order control) consisting 
of three LF's and the number of DEL characters sDecified by this 
argument Is generated if the following conditions are met. (If the 
conditions are not met, no head-of-form sequence is generated). 

. The first byte of the aop11cation's buffer must be designated 
as a control bytei i.e., bit 4 of the lORB's device specific 
word <I_DV$) must be set to 0 to write time. 

^ The control byte must specify that a head-of-form seauence is 
to be generated* t.a., bit 3 of the control byte must be set 
to 1. 

. Device type PRU is not specified. If it Is specified, a true 
head-of-form is Issued. 
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ATD 


In the field or TTY modes* an LF In an end-of—message sequence <post 
order control) Is followed by the number of DEL characters specified 
by this control argument* 

The EOM sequence Is controlled by the B- and C—bits of the IORB's 
device-specific word I_DVS, as.specified by the application at write 
time. The TTY line protocol handler sends an EOM sequence according 
to the following B- and C-bit values* 


XJ3VS Bits 

B C 

0 0 

0 I 

I 0 

I 1 


EOM Sequence 


CR 

None 

CR,LF,DEL characters 
LF,DEL characters 


At read time, the application can specify the same B- and C- bit 
values in order to send an EOM seouence back to the terminal when 
the message Is successfully received. 


Note that an LF character in a pre-order control specified by the 
X„CoN word of I ORB is never followed by a DEL character, l.e., this 
control argument has no effect in this case. 


This argument allows you to select 1 to 32 DEL characters. The 
default for each type of device is as follows* 


Device-Type Number of DEL Characters 


7200 0 

7800 0 

PRU1001/1003/1 005 I 

TTY I 

PRUI 004 32 


I stop-bitJ 

Specifies the number of stop bits that are to follow each character. 
A value of I or 2 can be chosen for each device. Default values are 
as follows* 

Number of Stop Bits 

1 

(For speeds greater 
than 110 bits per second) 

2 

(For a speed of 110 bits 
per second or less) 


[parity] 

Specifies the type of parity (“ODD" or 4, EVEN W ) to be used. The 
default is EVEN. 


6-20 



Example i 


ATT) 15,17,X'F800',0,I50,'720CK 

In this example a VIP 72-00 terminal Is connected to a line serviced 
by the AID line protocol handler. The device defaults for del, 
stop-bit, and parity are assumed. 
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BSC DIRECTIVE 


Directive Name* BSC 

The BSC directive Identifies a station serviced by the binary 
synchronous communications line protocol handler.(l) 


Format* 

BSC Irn, level, X' channel-', I modem], t primary/secondary], 
£charac ter.se tl£ f multi.block.count] 


Argument Description* 
irn 

The logical resource number associated with the station. The value 
for irn is an integer from 3 through 252. A program may use this 
number to Identify the station when it requests an input/oytput 
operation to the station. 

level 

This priority.level at which the communications supervisor processes 
requests for an inout/output operation to the station. The value for 
level is an integer from 7 through 621 it may be the same as the 
level specified for other communications stations* but it must be a 
higher number than the communications interrupt level(s) specified 
in the COMM directive; The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


( I) 

In the station is to be accessible through the file system 
Interface, an appropriate DEVICE directive must be "paired" with te 
BSC directive (See "DEVICE Directive," later in this section). If 
input/output to the station is to be asynchronous, the B (buffered) 
argument must be included in the DEVICE directive. 



X y channaly 

A four-digit hexadecimal number (from X- / 040n to X'FFBn'), specifying 
the channel number of the station and the interrupt priority level 
(n) of the line. The channel number has the following format* 

Bits 0 through 9 - The 10-bit channel acfclress of the send or 

receive channel on the line. 

Bits 10 through 13 — Must be set to zero. 

Bits 14 and 15 - Specified n, the priority level at which a 

communications line interrupts the central 
processor, n may have a value of 0,1,2. or 3 as 
specified in the CcWM directive. See the 
description of the C(l'*M directive for further 
information. 


Cmodem! 

A number specifying the type of data set. Possible values are as 
follows* 

0 — Direct connect. 

2 - Bell 2xx-type modem (201 A, 208B, etc). The data-set-ready signal 

is needed for a connection* absence of this signal is a 
disconnected* 

3 a greater - User-defined modem type (see “MODEM directive,'* later 

in this section). 

The default value is modem type 2. 

Cprimary/secondary1 .- 

Values may be specified as P or St indicates whether this is a 
primary or secondary endpoint of the transmission, A primary 
endpoint (the default) has priority in contention mode. 

£character-setJ 

One of the following may be specified* 

AS ASCri (the default). 

EB EBCDIC. 

The user is responsible for using the correct character set. The BSC 
protocol does not perform character translation. 
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BSC 


Emulti^bloek^eount] 

An integer from I to 7 specifies the maximum number of data blocks 
for a single transmission in multl„block mode. The default is that 
multi—block mode is not used. 

Example t 

BSC 29, 6 , X'FDOO',2,5,ES 

DEVICE B$G0Q,29,6,X^FD0CK f HOST** B 

In this example, line FDOO is used for communications with another 
computer. Modem type 2 is used for the line. The Level 6 computer 
is the secondary endpoint on the line. A file system interface is 
established for the station by the DEVICE directive. Multiblock mode 
is not used. 





COMM 


COMM DIRECTIVE 


Directive Mamet COMM 

The Co.MM directive Is mandatory In a system that Includes 
communications. It specifies from one to four priority levels at 
which communications lines can interrupt the central processor. The 
COMM directive must precede all other communlcatlons-related CLM 
-fl'fec t i'vgTI 


Format t 

COMM leveled C t Clevel,!It,[level_2]C,tleve1.3]31] 


Argument Description* 

level_0 

(level.!) 

Cleve1.2) 

Ilevel_3J 

The four possible oriorlty levels at which a communications line 
interrupts the central processor. At least one oriorlty level must 
be specified. . Values for levei_0 through leve1_3 must be in the 
ran?e of 7 through 61 and must not duoilcate any other 
non-communications device priority levels. Each value chosen for 
levels0 through level_3 must be greater or equal (have a lower or 
equal oriorlty) to the preceding level. The default values for 
level.! through leval_3 are eoual to the value assigned to the next 
highest priority level (level.(n-J)). For example, if a oriorlty 
value has not been assigned for level.2 In a COMM directive, the 
priority value specified for levels I Is assumed. (See the third TTY 
directive In the example that follows). 


Functional Description* 

The COMM directive specifies from one to four priority levels at 
which communications lines can Interrupt the central processor, as 
described above. 

The interrupt level for a communications line Is specified by the 
values of bits 14 and 15 of the channel number argument In the 
directive that Identifies the line. Bits 14 and 15 correspond to the 
positions of the level.n arguments specified in the CQMM directive. 
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COMM 


Example * 



priority 

(interrupt) 

level 

COMM 

10, II 



TTY 

20,20,X'FFOO', , , , 

leva1.0 

10 

asc 

2 J ,21 , X'FCOK , 

level.1 

1 1 

BSC 

22,22 ,X # FC8K „, 

level.I 

11 


In this example, three line protocol handlers are configured. The 
TTY associated with Irn 20 processes interrupts on level 10* the BSC 
station with Irn 21 processes interrupts on level U, as does the 
BSC station with Irn 22,. 





DEVICE 


DEVICE DIRECTIVE 


Directive Name* DEVICE 

The DEVICE directive is required for a communications station only 
If it Is to be accessible through the file system interface. In this 
case, the DEVICE directive must be “paired 1 * with the aporopriate 
station-defining directive (i.e., TTY, ATO, STD, VIP. BSC, PVE, 

HASP, or RCI) so that each oair contains the same lrn, level, and 
channel number. You may float channel numbers, if you wish. The 
DEVICE directive should follow related LPHDEF, STATION, and LPHn 
directives and related POLIST, STAPOL, ROP, STDLN, and STD 
directives. 

You must include a special format of the DEVICE directive In your 
CLM file if your Installation will use a dual-ourpose operator 
terminal. Refer to “Configuring a Dual-Purpose Operator Terminal 1 ' 
in Section V. 


Format* 


DEVICE device_unit,lrn,level.X'channel',tdevice_name], 


£ record_size] 



Argument Description* 


device_unit 

A string of up to six ASCII characters* the first three or four 
characters identify the type of station and the last character 
(alphanumeric) identifies one specific station of that type. The 
permissible values of devlce„unit are as follows* 


TTYnn 

BSCnn 

XBSCnn 

VI Pnn 

PVEnn 

ROPnn 

ATDnn 

STDnn 

HASPnn 

RCInn 


The default characteristics of various tyoes of stations are given 
below. Some of the default characteristics are specified by the 
default value of the device specific words (dsw). Certain default 
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DEVICE 


characteristics for any station in the configuration can be changed 
by use of the CLM directive STTY which is described later in this 
section. The description of the STTY directive includes an 
explanation of the device specific words. 

In addition, a user can override (temporarily change) certain 
default characteristics of a station he is using by the system 
command .STTY or the macro call 5STTY, 

TTYnn 


. Record site* 73 bytes (including control byte) 

• Device specific word for connect/disconnect * 0 

- No autodial used 

— Hang up phone on disconnect 

— Queue abort 

• Device specific word for read/write = 0030 (hexadecimal) 

— Trailing carriage return 

- Trai lig line feed 

- Echo mode 

* Leading control byte 

• Detab is on 

. Input is asynchronous 
. Output is asynchronous 

• Type is bidirectional 


SSCnn 


. dCS 2780 protocol 

. Record site* 137 bytes (including control byte) 

. Device specific word for connect/disconnect » 0 

- No autodial used 

- Hand up phone or disconnect 

- Leading control byte 

- Queue abort 

— Buffer mode is single record 

• Device specific word for read/write * 0000 (hexadecimal) 

- Leading control byte 
* . Detab is OFF 

• Input is nonbuffered synchronous 
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. Output Is nonbuffered synchronous 

• Type is input only between connects or output only between 
connects 

XBSCnn 

. BSC'3780 protocol 

. Record size* 137 bytes (Including control byte) 

, Device specific word for connect/d isconnect » 0 

— Hang up phone on disconnect 
— Queue abort 

• Device specific word for read/write * 0040 (hexadecimal) 

- Leading control byte 

• Oetab is OFF 

. Input is asynchronous 

• iXitput is asynchronous 
. Type is bidirectional 

VIPnn 


• Record size* 81 bytes (Including control byte) 

. Device specific word for connect/disconnect * 0100 
(hexadecimal) 

- Logical read time-out interval is 10 minutes 

- Mo autodial is used 

- Home cursor on page overflow 

- Leading control byte 

- Poll interval of one second (ignored is nonpolled VIP) 

- Hang up phone on disconnect 

- Queue abort 

- Do not save function codes in read IORB (Input/Output Request 
Slock) 

. Device specific word for read/write * 0010 (hexadecimal) 

- Trailing carriage return 

- Trailing line feed 

- Input/Output is asynchronous 

- Type Is bidirectional 


PVEnn 


• Record sizei 81 bytes (including control bytes) 
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DEVICE 


. Device specific word for connect/diconnect = 0 

- No autodial is used 

- Do not save function codes in read IORB. 

- Hang up phone on disconnected 

- Queue abont or disconnect 

. Device specific word for read/write * 0 
. Detab is ON 
. Input Is asynchronous 
. Output is asynchronous 
• Type is bidirectional 
ROPnn 


. Record size* 73 bytes (including control byte) 
, Device specific word * 0000 (hexadecimal) 

- Trailing carriage return 

- Leading control byte 

- Physical disconnect 

- Queue abort 

• Detab is ON 
. Input is asynchronous 
. Ouptut is asynchronous 
. Type is output 


ATDnn 


. Record size* 73 bytes 

• Device specific word for conneet/disconnect “ 0 

- No autodial is used 

- Hang up phone on disconnect 

- Queue abort 

. Device specific word for read/write * 30 (hexadecimal) 

- Echo input character (echo mode) 

- Line feed at end of message (EOM) 

. Detab is ON 

* Input is asynchronous 

. output is asynchronous 
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Type Is bidirectional 


' STOnn 


* Record size* 81 bytes 

. Device specific word for connect/disconnect * 103 (hexadecimal) 

- No autodial Is used 

- Home cursor on page overflow 

- Leading control byte 

- Logical poll Interval * I second 

- No soace suppress 
— No roll 

— Hardware function, eodes are specified In write requests 

- No timeout on read request 

- Send OLE EOT (Data Link Escape; End of Transmission) (7804) 
on disconnect 

- Hang up phone on disconnect 

- Queue abort * 

. Device specific word for read/write * 10 (hexadecimal) 

- Carriage return at end of message 

- Line feed at end of message 
— Print one copy (7804) 

HASPnn 

, Record size* 520 bytes (including control bytes) *• 

. Device specific word for connect and disconnect * 0000 
(hexadecimal) 

- Queue abort 

- Hang up phone on disconnect 

* Device specific word for read/write * 0100 

- Leading control byte 
. Detab Is ON 

. Input is asynchronous 
- Output Is asynchronous 
« Type is bidirectional 
RCI nn 


. Record size* 132 bytes (Including control byte) 

. Device specific word for connect and disconnect * 0003 
- Do not hang up phone on disconnect 
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DEVICE 


- No queue abort 

. Device specific word for read/write » 0100 

- Do not quit upon receiving break 
~ Leading control byte 

. Detab is ON 

. Inout is synchronous 

c Output is synchronous 

* Type is bidirectional 

lrn ' 

The logical resource number of the station identified by the ATD, 

STD, TTY, VIP, BSC, PVE, HASP, or PCI directive with which this 
DEVICE directive is "paired". (A ROP is identified in a VIP 
directive). The value of lrn is an integer from 3 through 255. 

1 e ve 1 

The priority level of the station identified by the ATD, STD, TTY, 
VIP, BSC, PVE, HASP, or RCI directive with which this DEVICE 
directive is "paired". 

The value for level is an integer from 7 through 61t it may be the 
same as the level specified for other communications stations, but 
it must be a higher number than the communications interrupt 
levei(s) specified In tfteOOMM directive. The level specified for 
one or more communications stations may not also be used for 
noncommunications devices or tasks. 

X'channel 

The channel number of the station identified by the ATD, STD, TTY, 
VIP, BSC, PVE, HASP, or RCI directive with which this DEVICE 
directive Is "paired". Sits 10 through 15 of the channel number 
specified in a DEVICE directive should equal 0 even though they may 
not equal 0 in the "paired" directive. Bits 15 and 16 of the channel 
number soeeified in a DEVICE directive do not indicate the interrupt 
level of the communications line. You can float this channel 
assignment by specifyig a single zero (0), if you wish. 

C devlce_name) 

A string of 1 to 12 ASCII characters, the first of which must be 
alphabetic. This devlce^name is a unique name by which the station 
can be referred to within the file system. If a deviee_name is not 
specified, the device„unit argument is used as the device_naroe. 

trecord„sizeJ 

The length, in bytes, of one physical record. If record_slze is not 
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specified* the default record.stze Is as established by the 
device.unit argument. 



For normally unbuffered stations (viz.* BSC* HASP, PCI)* 5 Indicates 
that input/output to the station is to be buffered. 

For normally buffered stations (viz.*. TTY, VIP, PVE, ROP), N 
indicates that input/output to the station 1$ to be unbuffered. 

For TTY* VIP, ROP, PVE, AID, and'STD stations, the default is 
buffered . For HASP, RCI, BSC, and XBSC stations, the default Is 
unbuffered. 


Input/output to a buffered station may be asynchronous or 
synchronous . Input/output to an unbtjffered station is always 
synchronous * tabulation characters are not expanded. 

For a BSC 3780 (XBSC) station. Input/output must be asynchronous. 
Therefore, this argument must not be specified as N for an XBSC 
station. 

For the following station types* 

TTY 

VIP 

PVE 

ROP 

AID. - - - 

STD 

HASP 

RCI 

tabulation characters are normally expanded into space characters. 
Tabulation characters are not expanded if N is specified for these 
station types. Tabulation characters are never expanded for BSC or 
XBSC station types. 


Functional Description* 

If a communications station is to be accessible through the file 
system interface, the station's TTY, VIP, ATO, STD, BSC, PVE, HASP, 
or RCI directive must be “paired 1 * with a DEVICE directive. The Irn, 
level, and channel numbers for each pair of directives must be 
identical. (Mote that this requirement applies to an 
,MLCP/DLCP-connected operator terminal). 

Multiple DEVICE directives that specify the same Irn and level are 
Invalid. The EQLRN directive (described elsewhere in this section) 
allows you to equate multiple lrn's for a device. 
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Example t * 

TTY 21,8,X'FF80',,300 

DEVICE TTY 00,21 ,8 t X'rr8CK .TTY FILE 

In this example, a TTY Is to be accessible through the file system 
interface*' The DEVICE directive contains the same Irn, level, and 
channel number as the TTY directive; The default characteristics of 
the station are shown under the device„unit argument above. The 
default record size (73 bytes) 1$ also to be used since no 
record.slze argument is specified in the DEVICE directive* The 
device name TTYFILE is to be used for references to the station 
within the file system* 


Example 2< 


SYS 




STDLN 10, X'FFOO', 2,2400, W4 
STD 20,0,,V7805 
ROP ROSY26 
STD 21,1 ,-,V7804 
‘STD 22,2 
POLIST 2 
STAPOL 0,1,0,2 

DEVICE STD0O,2O,I0,X'FF00',V7805,80,B 
DEV ICE STD02,21,10,X'FFOO',V7804,80,B 
DEVICE STD03,22,10,X'FF00',V7804,80,B 


In this example, three synchronous devices are to be accessible 
through the file system interface. DEVICE'STDOO, DEVICE STD02, and 
DEVICE STD03 directives are paired with the first, second, and thrld 
‘STD directives in the GLM file* Note that each DEVICE directive has 
the same Irn, level, and channel number as specified in Its paired 
STD directive* DEVICE directives may appear anywhere in your CLM 
file* 
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EQLRN DIRECTIVE 


Directive Name* EQLRN 

The EQLRN directive allows you to specify multiple logical resource 
numbers (Irn-'s) for the same physical device* Although each device 
in a communications configuration must be assigned a unique Irn* the 
EQLRN directive permits you to •equate 1 * two or more Irn's to 
reference the same physical device. 


Format* 

EQLRN Irn ,lrn [ *lrn *...] 
p s s 


Argument Description* 
lrn 

(p) 

The primary logical resource number associated with the physical 
device; This argument must be specified. 

irn 

(s) 

The secondary logical resource number(s) that will be associated 
with the device being referenced by irn(p). You must specify one or 
more lrn(s) arguments. Values you soecify for IrnCs) must be 
numerically less than the largest lrn used in a communications 
DEVICE directive or any other communications directive. 

The foilwing example illustrates one possible application of the 
EQLRN directive* 

A communmications device can be driven with two different sets of 
device characteristics via the same user-written driver. Each 
different logical device is referenced by a unique file name. This 
requires two separate communications DEVICE directives, each 
specifying a unique file name. The device characterlsties are 
specified by STTY directives. 
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The following set of CLM directives illustrate those directives 
which roust he included at configuration timet 


4 

comm 9 

LPH3 32,32,X'FF8CK,,4900 

DEVICE TTY05,32,32,X'FFB0',CDROO,80 

STTY CDROO, ,X / C)C0CK , ,S 

DEVICE TTY0£,33,32,X'FF80',CRP00,80 

STTY CRPOO,tX^OSOO*,OFF 

EQLRN 32,33 


AID 35,35(X'FFOO^,0,9600,'7200' 
DEVICE TTY07,35,35,X'rF00',,,N 


Note that the last two directives above specify an lrn that is 
numerically larger than those specified in the EQLRN directive. The 
irn's specified in the EQLRN directive must be numerically less than 
the largest lrn specified in any other communications directive. 
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HASP DIRECTIVE 
directive Name* HASP 

The HASP directive identifies an IBM workstation on a line serviced 
by the HASP line protocol handlerst) 

rormat * 

HASP lrn,level.X'channel',[modemJ 


Argument Description* 
lrn 

The logical resource number associated with the station. The value 
for lrn is an Integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 

level 

The priority level at which the communications supervisor processes 
requests for an Input/output operation to the station. The value for 
level Is an integer from 7 through 61t It may be the same as the 
level specified for other communications station, but it must be a 
higher number than the communications interrupt ievelCs). specified 
in the comm directive.' The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


If te station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired* 1 with 
the HASP directive (See DEVICE Directive," earlier in this 
section). If input/output to the station is to be asynchronous, the 
B (buffered) argument must be included in the DEVICE directive. 
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X'cha nnel' 


A four-digit hexadecimal number (from X'040iV to X'FFSn*') specifying 
the channel number of the station and the interruot priority level 
(n) of the line. The channel number has the following format* 


Sits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line, 

flits 10 through 13 — Must be set to zero, 

flits 14 and 15 - Specifies n* the priority level at which a 

communications line interruots the centra 1 
processor, n may have a value of 0,1,2, or 3 as 
specified in the COMM directive. See the 
description of the COMM directive for further 
information. 


[modem] 

A number specifying the type of data set. Possible values are as 
follows * 

0 - Direct connect. 

2 - Sell 2xx-type modem (201 A, 2080, etc.). The data-set-ready 

signal is needed for a connection; absence of this signal is a 
disconnection. * 

3 or greater — User-defined modem type (see "MODEM directive", later 

in this section), 

The default value is modem type 2. 
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H3270 DIRECTIVE 


Directive Name* H3270 

The H3270 directive identifies a station on a line serviced by the 
8SC 3270 line protocol handler. Only one station may be configured 
on a line. 

Format * 

H3270 lrn ( level .X'channel*', [modem J *X y poll_address', 
X'select__addresr' 


Argument Description* 

Irn 

The logical resource number associated with the station. The value 
of irn is an integer from 3 through 255. A program may use this 
number to Identify the station when it requests an input/output 
operation to the station. 

level 

The priority level at which the communications supervisor processes 
requests for an inout/output operation to the station. The value for 
level is an integer from 7 through 61* it may be the same as the 
level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
In the C£lAIM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 

X'channei 

A 4-digit hexadecimal number (from X'040n' to X'FFSiy'), specifying 
the cnannel number of the station and the interrupt priority level 
(n) of the line. The channel number has the following format* 

(Sits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

Sits 10 through 13 - Must be set to zero. 

Sits 14 and 15 - Specifies n, the priority level at which a 

communications line interrupts the central 
orocessor. n may have value of 0, I, 2, or 3 as 
specified in the COMM directive. See the 
descriotion of the COMM directive for further 
information. 
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[moden] 

A number specifying the type of data set. Possible values are as 
follows * 

0 - Direct connect. 

2 ** Bell 2xx»type modem (201 A, 208B, etc.)» The data-=set—ready 

signal is needed for a connection* absence of this signal is a 
d i s connec t i on . 

3 or greater - User=defined modem type (see "MODEM Directive", later 

in this section). 

The default value is modem type 2. 

X'poli„address / 

A 2*=digit hexadecimal number (from X'00' to X'FF') specifying the 
poll address of the 3270 control unit. 

X'seieet„address' 

A 2-digit hexadecimal number (from X'00' to X'FF') soecifying the 
select address of a 3270 device. 

Example * 

H3270 25.20.X'FC00',2«X'A0' t X'40' 

In this example the host will use an address of X'fiO' to poll this 
station and an address of X'40' to select this station. 




LPHn DIRECTIVE 


LPHn 


Directive Name* LPHn 

The LPHn directive identifies the first (or only) station on a line 
serviced by a user-written line protocol handler.(l) 


Forma t * 

LPHn lrn, level, X'channel, [ modem] ,C speed!, 

CFDX/HDX JC•lph_soecific_word 3 

In the directive name LPHn, n is an integer from 0 through 3 and 
identifies a soecific line orotocol handler- If an _PHDEF directive 
is used in associated with this line protocol handler, the value of 
the iph argument in the LPHOEF directive must match n,(2) 


Argument Description* 
lrn 

The logical resource number associated with the station. The value 
for lrn is an integer from 3 through 255, A program may use this 
number to identify the station when it requests an input/outout 
operation to the station. 

level 

The priority level at which the communications supervisor processes 
requests for an input/output.operation to the station. The value for 
level is an integer from 7 through Alt it may be the same as the 
level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
In the COM^ directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 


(I ) 

The LPHn directive is also used In conjunction with the Remote 
Batch Facility. See Appendix F. 

( 2 ) 

The value No. 1 is used to configure the ACTD LPH. 
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X'channel-' 


A four-digit hexadecimal number (from 'X040n y to X'FFSn-'), 
specifying the channel number of the station and the interrupt 
priority level (n) of the line. The channel number has the 
following format* 

Bits 0 through 9 - The tO-bit channel address of the send or 

receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which a 

communications line interrupts the central 
processor* n may have a value of 0, I* 2. or 3 
as specified in the COMM directive* See the 
description of the COMM directive for further 
information. 

t modem] 

A number specifying the type of data set. Possible values are as 

follows * 

0 - Direct connect. 

1 - Bell 1xx-type modem (I03A* etc.). Both data-set-ready and 

carrier-detect signals are needed for a connection* absence of 
both signals is a disconnection. 

2 - Bell 2xx-type modem (201 A, 208B* etc.). The data-set-ready 

signal is needed for a connection* absence of this signal is a 
disconnectlon. 

3 or greater - User-defined modem type (see "MODEM Directive", later 

in this section). 

The default value is modem type 2. 

C speed ] 

The data rate in bits per second. 

For an asynchronous line with a communications-pac whose id is 

2108(14)* use one of the following values for speed* 

50 300 2430 

75 400 3400 

(default) !!0 900 4800 

134 1200 7200 

150 1800 9600 
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For an asynchronous 

line 

wi th a 

communications-pac whose 

Id is 

21G0<16), 2110(16)* 

or 2118(16) 

, use one 

of the following 

values 

speed * 

50 

200 

1800 




75 

300 

2000 



(default) 

no 

600 

2400 




134 

1050 

4800 




150 

1200 

9600 



NOTE* If the data rate Is 

134.5 

, sp ec 1 fy 

134. 



for 


For asynchronous terminals you have the option to defer selection of 
the line speed until the terminal comes on-line. You select this 
option by specifying HI or U>. 

'HI' 

Specifies that all terminals associated with this line will be 
permitted to function only at speeds from 1200 through 9*00 
bits per second. 


'LO' 

Soeclfies that all terminals associated with this line will be 
oermitted to function only at speeds from J1Q through 1200 bits 
per second. 

For more information about the line soeed selection capability, 
refer to the discussion under "Topics Related to CLM Directives" 
near the beginning of this section. 

IFDX/HDX1 

Specifies whether the line is full- or half-duplex. If It is 
full-duplex (FDX>* two channel tables will be assigned. The default 
value Is HOX. 

Iiph_speciftc.word1 

A word containing user-defined Information to be passed to the line 
protocol handler through the station table at offset ZOSSTS. The 
default is zero. 

Functional Description* 

The LPHn directive must be Included once for each line (i.e., pair 
of channels) of an MLCP/DLCP on which there are stations to be 
driven by a user-written line protocol handler. An LD9U directive 
(described in Section V) must be included among the CLM directives 
so that the ConfIguration Load Manager will load the user-written 
line orotocol handler bound unit and execute its initialization 
code. If the sizes of the channel and station tables are different 
from the default sizes for these tables, an LPHDEF directive must be 
included before the related LPHn directive(s>. The values soecified 
In the LPHDEF directive apply only to the LPHn and STATION 
directives that immediately follow the LPHDEF directive in a CLM 
file. 
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LPHn 


If there is more than one station on a line driven by the 
user-written line protocol handler, the additional stations on the 
line must be identified by STATION directives that immediately 
follow the LPHn directive (See ‘•STATION Directive,” later in this 
section). 

Example * 

LPHO 27 ,8,X'FD8CK ,,,FDX 

STATION 28, J 

In this example, there are two stations on a synchronous, 
fuTl*=duplex line controlled byy a use rewritten line protocol 
handler. 


6-44 




LPHDEF 


LPHDEF DIRECTIVE 


Directive Name* LPHDEF 

For each line protocol handler you write* you can include an LPHDEF 
directive to define the sizes of tables used for the channels and 
stations controlled by the line protocol handler. If the LPHDEF 
directive is not included, channel table and station table default 
sizes will be used for channels and stations controlled by the line 
protocol handler (see channel_table_size and station_table_size 
arguments below). 


Format * 

LPHDEF lrh,Cehannel_table_sizeJ C,statlon_table_size] 


Argument Description* 
iph 

An integer from 0 through 3 that associates this LPHDEF directive 
with a line protocol handler identified in one or more LPHn 
directives. 

C channel_table„siza1 

Specifies the number of words needed for the channel table and the 
OQB's (communications oueue blocks). It must have a value of at 
least 10 words. The default value Is 33 words. 

C station.. table_size J 

Specifies the number of words needed for this line protocol 
handlers station table (resource control table). It must have a 
value of at least 10 words. The default value Is 10 words. 

NOTE* The values specified for channel_table_size and 

station_table_size apply only to the LPHn and STATION 
directives that immediately follow the LPHDEF directive in a 
CLM file. 

Example * 

LPHDEF 0,30 

LPH0 27,3,X'F0d0', f ,FDX 

STATION 28,1 

In this example, line FD80 has two stations on a synchronous. 
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full-dupplex line controlled by a user-written line protocol 
handler* Each of the two charnel tables for the line has e site of 
30 words, as defined by the ehannel„table„size argument in the 
LPHDir directive* The default value ( 10 words) is a-ccepted for 
station„table„size. 
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MODEM DIRECTIVE 


Directive Names MODEM 

The MODEM directive defines a nonstandard modem type. The 
information provided In this directive Is used to test entries In 
the appropriate line control table of the MLCP/DLCP to verify a 
connection or disconnection. 

Standard modem types 3 and 4 have a connect feature for some 
European data sets that require data-terminal-ready to remain low 
until the ring Indicator Is turned on. This feature is activated by 
setting bit 7 of the data-set-control argument. 


rormat* 

MODEM type_number,connectlon_AND_mask,connectlon_XOR_mask» 
disconnection_AND_mask,disconnection_XOR_ma sk, 
data_set_control 


Argument description* 
type.number 

An integer from 3 to 15 that is assigned to this modem definition 
and may then be used in a communications station directive (t.e., 
TTY, vrp, BSC, HASP, RCI, PVS, and LPHn directives). 

connection.AND.mask 

A 2-digit hexadecimal number whose value governs which bits (i.e., 
from 3 through 3) of line register 5 (LR5) will be examined when a 
connect request is processed. 

conne c tio n.XOR_ma sk 

A 2-digit hexadecimal number whose value governs which bits (from 0 
through 3) of LR5 must b* ON (i.e., set to I) for a connection. 

disconnection.AND.mask 

A 2-dlgit hexadecimal number whose value governs which bits (I.e., 
from 0 through 3) of L35 will be examined when a disconnect request 
Is processed or when a test for the occurrence of a disconnect is 
made. 

disconnec tion.XOR.mask 

A 2—digit hexadecimal number whose value governs which bits (from 0 


A—47 



MODEM 


through 3) must be ON (i.e., -set to I) for a disconnection, 
da ta_set_control 

Specifies a 2-digits heaxdecimal number. Bits 0 through 4 are loaded 
unconditionally into bits 0 through of byte 20 of the appropriate 
line protocol table (LOT). The contents of LCT byte 20 are loaded 
into line register 2 of the communlcattons-pae when a line is to be 
connected. 

NOTES* 

1. To test for a successful conneetlon . the contents of LR5 are 
first subjected to a logical AND operation against the 
(user-supplied) eonnection_AND_maskt then a logical exclusive 
OR operation is performed on the result of the first 
operation, against the (user-supplied) connect!on_XOR_mask. If 
the result is zero, a connection has been established. 

2. To test for a disconnect . the same operations are carried out 
using the analogous disconnection masks. A zero result 
indicates a disconnection. 

3. The following shows the mask and data set control values for 
the standard CLM-recognized modem types* 


Adapter 

Type 

Modem 

Type 

CONNECT 

AND 

Mask 

XOR 

DISCONNECTION 

AND 

Mask 

XOR 

Data Set 
Control 

A SYNC 

0 . 

X'80' 

X' 00' 

X'80' 

X'OO' 

X'80' 

SYNC ' 

0 

X'80' 

X'80' 

X'SO' 

X'OO' 

X'80' 

A SYNC 

1 

X'OA' 

X'AO' 

X'AO' 

X'OO' 

X'80' 

SYNC 

2 

X'80' 

X'80' 

X'80' 

X'OO' 

X'80' 

ASYNC 

3 

X'AO' 

X'ACK 

X'AO' 

X'OO' 

X'8 1' 

SYNC 

4 

X'8CK 

X'8CK 

X'80' 

X'OO' 

X'8 1' 


Line register 5 and byte 20 of the LOT are shown below See the 

Communications Handbook for a detailed description of these_ 

entities. 
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Line Register 5* 


0 

t 2 3 

4 

in 

i 

7 


DATA SET STATUS 


COMMONICATIONS-PAC 

STATUS 

DATA 

SET 

CARRIER 

RSU DETECTOR RSU 

RSU 

RSU RSU 

RSU 


READY 


LCT 3yte 20/Data 

Set 

Control* 





0 1 

2 

3 

4 

5 

6 

7 


DATA SET STATUS COMMUNICATIUNS-PAC STATUS 


Da ta 



Synch¬ 


Moni tor 

Terminal RSU 
Ready 

RSU 

RSU . 

ronous RSU 
Direct 

Connect 

RSU 

for Ring 
Indicator 


Example I * 

MODEM 3,X'20',X'20',X'20',X'00',X-'88' 

In this example, a modem t/pe requiring only the carrier-detect 
signal for a connection and absence of this signal for a 
disconnection is defined. 
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POUST 

POLIST DIRECTIVE 


Directive Name* POLIST 

POLIST specifies the time Interval between successive scans of the 
poll list. The POLIST directive must precede the poll list. 


Format* 

POLIST. tpoU_eycle.de lay J 


Argument Description* 
t poll.eycle.delay 3 

Defines the time Interval in seconds between successive scans of the 
poll list. After completing a scan of the poll list the driver waits 
the specified time interval before re-scanning the poll list. If 
this parameter is specified, it must be in the range of 1 to 10 
(seconds). If not specified, the default is 1 (second). 
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PVE DIRECTIVE 


Directive Name* PVE 

The PVE directive identifies a polled VIP or STD emulated station on 
a line serviced by the VIP or STD line protocol handler. <1,2*3,41 


Formati 

PVE lrn,level.X'channel*',[modem!,poli_addressE ,poll_response] 
t *controller - poli - ,address 1 


Argument Description* 
irn 

The lo?ical resource number associated with this station* The value 
for lrn is an integer from 3 through 255* A program may use this 
number to Identify the station when it requests an Input/output 
operation to the station* 


( I) 

PVE directives are used in configuring the system at the end of the 
communications line where polled VIP emulation is to be performed. 
The system at the other end of the communications line must be 
configured with a VI? directive for each PVE direct!vet the poll 
address in each pair of directives must be the same. 

( 2 ) 

A single communications line have up to 32 polled VIP stations. The 
total of 32 may be achieved by any combination of actual VIP 
stations or emulated stations. At your option, up to 32 stations 
may be combined in groups of 8 when emulating a VIP 7760 line. Ail 
stations in a group must specify the same controller poll address, 
as if they were connected to one VIP 7760 controller. 

(3) 

If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be “paired** with 
the PVE directive (see “DEVICE Directive* 1 , earlier in this 
section)• 

( 4 ) 

A station can consist of up to 3 addressable components 
(scrren/keyboard, ROP, and/or cassette). 
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P.VE 


1 evel 

The priority levei at which the communications supervisor processes 
requests for an Input/output operation to the station. The value for 
level is an integer from 7 through 611 it may be the same as the 
level specified for other communications station* but it must be a 
higher number than the communications interrupt leveHs) specified 
in the COMM directive.' The levei specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks*, The level of all PVE stations on a common 
MLCP/DLCP channel must be the same. 

channel^ 

A four-digit hexadecimal.number (from X'CMOrT to X^FFSn')« 
specifying the channel number of the station and the interruot 
priority level (n) of the line! The channel number has the 
following format * 

Bits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

Bits 10 through 13 — Must be set to zero. 

Bits 14 and 15 — Specifies n* the priority level at which a 

communication line interrupts the centrai 
processor* n may have a value of 0* 1, 2, or 3 
as specified in the COMM directive. See the 
description of the Comm directive for further 
information. 

(modem] 

A number specifying the type of data set. Possible values are as 
follows t 

0 - Direct connect. 

2 - Bell 2xx-typ@ modem (201A* 2088* etc.). The data-set-ready 

signal is needed for a connection! absence of this signal is a 
disconnection* 

3 or greater - User-defined modem (see “MODEM Directive" earlier in 

this section). 

The default is modem type 2. 
poll„address 

Specifies the poli_address of this station on the line identified by 
the channel argument. The □©Headdress argument is an integer from 0 
through 31. Each station on the line must have a unique 
poll.address. 
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[ poli_.response ] 

Specifies the type of response that PVE will generate if a select 
and/or poll is received for a station that is not logically 
connected. The possible values are* 

DA - If a non-connected station is selected to receive data, PVE 
will respond to the subsequent poll with a positive 
acknowledgement (ACfO • 

If a non-connected station is simply polled, PVE will respond 
with a quiescent (0) frame. 

ON - If a non-connected station Is selected to receive data, PVE 
will respond to the subsequent poll with a negative 
acknowledgement (NAK). 

If a non-connected station is simply polled, PVE will respond 
with a quiescent <Q) frame. 

Default* No response to poll. 

Icontroller_poll_address1 CVIP 7760 only] 

The controller poll address associated with this station on the 
line* It equals the poll address of the VIP 7760 controller to 
which this station Is connected. This station emulates a VIP 7760 
station having the same controller poll address. 

controller_poil_address must be an integer ranging from 0 through 7. 
Several stations on the line may have the controller poll address. 

Default* No controller poll address Is assigned for this station. 

Example* 

PVE 30,9,X'FD8<X,,0 
PVE 3),9,X'FD80',,I 
PVE 32,9,X'FD80'', ,2 

In this example, three polled VIP emulated stations are defined for 
a conmunlcations line (FD80). Each station has a unique lrn and 
poll_address.' The default value (2) Is established for modem type. 

The system at the other end of the communications line must be 
configured with VIP directives for the same physical line* each 
poli.address in a VIP directive Cin system "A"). 


/ 
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RCf 

RCI 01 RECTIVE 


Directive Name* RCI 

The RCI directive identifies a station on a line serviced by the 
Remote Computer Interface (RCI) line protocol handler*(I) 


Format* 

RCI lrn, leva 1 t X-'channel' f l modem J 


Argument Description* 
irn 

The logical resource number associated with the station* The value 
for Irn is an integer from 3 through 255* A program may use this 
number to identify doe station when it requests an inout/outout 
operation to the station. 

level 

The priority level at which the communications supervisor processes 
requests for an input/output,operation to the station. The value for 
level Is an integer from 7 through 61 I it may be the same as the 
level specified for other communications stations, but is must be a 
higher hyrckftT* than the communications interrupt level (s) spec if led 
in the UOMM directive. The level specified for one or more 
communications stations ma/ not also be used for noncommunications 
devices or tasks* 


(1) 

If the station Is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired 1 ' with te 
RCI directive (see "DEVICE Directive", earlier in this section). If 
Input/output of the station is to be asynchronous, the B (buffered) 
argument must be included in the DEVICE directive. 
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X y channel y 

A A four-digit hexadecimal number (from X / 40n / to X'FFSn') 
specifying the channel number of the station and the interrupt 
priority level (n) of the line* The channel number has the following 
format i 

* 

3its 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line* 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which a 

communications line Interrupts the central 
processor, n may have a value of 0. 1, 2, or 3 
as specified In the COMM directive. See the 
description of the Comm directive for further 
information. 


t modem 

A number specifying the type of data set. Possible values are as 
follows* 

0 - Direct connect. 

2 - Sell 2xx-type modem (201 A* 208B, etc.). The data-set-ready 

signal is needed for a connection! absence of this signal 1$ a 
disconnection. 

3 or greater r User-defined modem type (see "MODEM Directive", 

earlier in this section). 

The default value is modem type 2* 
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BOP 

ROP DIRECTIVE 


Direct!v* Names ROP 

The ROP directive specifies that a reeeive-only printer (ROP) is 
connected to a station on a line serviced by the STD line protocol 
handler* (See the STDLN directive for information on how to specify 
ROP directives in a CLAJ file)* 


Format* 

ROP rop.type 


Argument Description* 
rop_type 

Specifies the type of reeelve-only printer device that is connected 
to the station* Possible values for this argument are* 


corresponding 
rop type , device type 


1003 PR U! 003 

i 005 PR U1 005 

TN3Q0 Term!Net 300 

TB1200 TermlNet 1200 


One value for rop„type must be specified* 
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' STA^UL DIRECTIVE 


Directive Name* STAPOL 

The STAPOL directive defines the order in which stations are oolled 
on a line serviced by the .STD line protocol handler. The order in 
which stations are polled is determined by the position of arguments 
in the STAPOL directive. (See the'STDLN directive for example). 


rormat * 


STAPOL station jpo Headdress C ,station_poll_address 1 

2 


[ ,statlon - poll_address 1 

15 


Argument Description* 
statioo_poHeaddress 

n 

Specifies the poll address of a station on this line. Up to 15 
station oo11 addresses may be. specified. The station poll addresses 
must have been previously specified in the STD directive associated 
with this line. The value of this argument must be in the range 0 
through 31. It may be specified as many times as is necessary to 
create the polling priority list for the line. 
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STATION DIRECTIVE 


Directive Name* STATION 

The STATION directive identifies the second or subseouent station(s) 
on a line controlled by a user-written line protocol handler that 
drives multiole stations per line. One station on the line must be 
identified oy an LPHn directive! additional stations are identified 
by STATION directives, one oer station, immediately following the 
related LPHn directive (1)■ (See the LPHn directive for an evamole). 
STATION directives and LPHn directives must immediately follow the 
LPHDEF directive that defines them in a CLM file. 


Format * 

STATION Irnt,lph_specific_word J 


Argument Description* 
irn 

The logical resource number associated with the station. The station 
for irn is an integer from 3 through 255, A orogram may use this 
number to identify the station when it requests an input/output 
operation to the station. 

IIph„soecific_word] 

Specifies a word containing user-defined information that is to be 
oassed to the line protocol handler through the station table, at 
offset ZQSSTS. The default is 0. 

NOTE * The priority level, channel numoer, modem type, line speed, 

and line orocedure (FQX/HQX) of stations described in STATION 
directives are ohtained from the LPHn directive that precedes 
the STATION directive (See **LPHn Directive", earlier In this 
sec tion). 


1 

For additional (polled) VIP^s on a line, use additional VIP 
directives with the same level and channel number, rather than 
STATION directives. 
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STD DIHECTIVE t I ) 


Directive Marne* STD 

The STD directive Identifies a station on a line serviced by the 
synchronous terminal device (STD) line protocol handler. See the 
STULN directive for examples. 


Format* 

STD lrn«station - .poll_addresst ,,device_tyoe3 


Argument Description* 
lrn 

The logical resource number associated with the station. The value 
for lrn is an integer from 3 through 255. A program may us* this 
number to Identify the station when it requests an inout/outout 
operation to the station. 

s ta tion„po1l_addr ess 

Specifies the.poll address of this station. The poll address is an 
integer from 0 through 31. Each station on the line must have a 
unique statlon_poll_address. 

idevice_.type) 

Specifies the tyoe of VIP terminal used. Possible values for 
device_.type are* 


(!) 

The STD directive and the VIP directive suooort synchronous 
terminals. The line protocol handler called by the STD directive 
offers additional suooort capabilities (e.g., support of VIP7804 
and VIP7805 terminals) not offered by the line protocol handler 
called by the VIP directive. 
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deviee_type 


V7804 

V770Q 

V776Q 


corresponding 
terminal type 

VIP 7804/VtP 7805 

VIP 7700/VIP 7700ft/VIP 7705R 

VIP 7760, OKU 7005, DKU 7007 


If this argument is not specified, the default devlce^type is V7700. 


When using the Synchronous Terminal Driver <STD) line protocol 
handler, you must observe the following* 


. The master LRN station must be the last station to be 
disconnected. 


o The 7804 Control Byte Head of Form suDoort translates to a 7804 
clear escape sequence. This sequence, in addition to 
positioning the cursor to the Home row, puts the 7804 in text 
mode, 


» To use the STD LPH, the VIP 7804 hardware switches must be 
configured as follows* 

Reset, Text Mode, Verify before process. 

Transmit next block, 
optional settings are* 

Roll/No Roll 

Space/Ho Space 

Return * Tra ns mi t/Normal 

Set Block Size 


. VIP 7804 terminals are not compatible with VIP7700 terminals in 
the handling of end'-of-message CR's and LF' s. It is recommended 
that the new STD line protocol handler be used for VIP7804 
support. If the VIP line protocol handler is used to suDport a 
VIP7804 terminal, the following must be observed* 

1. RBTURN*NORMAL must be selected at the terminal. 

2. The XMT key should be used to enter commands. 

3. When using the Editor, Linker, or other utility directives 
with the prompt option, the RETLB7N key should be depressed 
before the SMT key. This will assure that the promt appears 
on the next line rather than at the and of the current line. 
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STDLN DIRECTIVE 


* f 

Directive Mamet STDLN . ' 

The TSQL.M directive identifies a line serviced by the STD line 
protocol handler. (The STDLN directive does not supoort floating 
channel number assignments. You must explicitly specify the channel 
number argument). 


rorma t * 

STDLN level.X'channel',t modem 1,t soeed H,2/4 wire 1 


Argument Description* 
level 

The priority level at which the communications suoervisor processes 
requests for an inout/output operation to the station. The value of 
the level is an integer from 8 through 58* it may be the same as the 
level soecified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also be used for non-communications 
devices or tasks. 

X-'cnannel 

A four-digit hexadecimal number (from X y ’40n / to X'FF3n') t specifying 
the cnanoel number of the station and the interrupt priority levei 
(n) of the line. The channel number has the following format* 

Sits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

3its 10 through )3 - Must be set to zero. 

31ts 14 through 15 - Specifies n. the orlority level at which a 

communications line interrupts the central 
processor, n may have a value of 0, I, 2, or 3 
as specified in the COM’* directive. See the 
descriotlon of the COMM directive for further 
information. 
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C modem] 

A number specifying the type of data set* Possible values are as 
follows* 

0 - Direct Connect 

2 * Bell 2xx-type modem (20IA, 208B* ect«)« The data^set—ready 

signal Is needed for a connection* absence of this signal Is a 
disconnection* 

'* . 

3 or greater - User-defined modem (See “MODEM Directive", in this 

section). 

The default 1$ modem type 2* 
fspeed ] 

The data rate in bits per second* The default value is 2000. other 
possible values for speed include. 

2400 
4800 
9600 
! 9200 


C2/4 wire] 

Specifies a 2 or 4 wire connection. Possible values are* 
. Value meaning 
(Default) W2 2-wire connection 

144 4-wire connection 


functional Description* 

The STDLN directive defines a line serviced by the STD line orotocol 
handler* it precedes all other directives which characterize this 
line. Configuring a line serviced by the STD line protocol handler 
requires that at least four different directives be specified for 
the line and all stations on the line. These directives must be 
specified according to the following guidelines* 

Required directives 


STDLN (specify one for each line) 

STD (specify one for each station on the line) 

POLIST (specify one for each line) 

STAPOL (specify one or more as needed) 

Optional directive 


ROP 
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Sequence rules 

The following diagram Illustrates the sequence rules that aoply when 
specifying STDLN and other STD directives* One set of these 
directives must be soecified for each line. Note that all directives 
which characterize the line must immediately follow the STDLN 
directive that identifies the line. Brackets enclose optional 
directives. 


STDLN must specify one for each line 
STD 

1 \ 

I specify one set for each 

ERonJ specify one for each ( station on the line! all must 

station. If needed l precede POLIST 

STD • 

2 

[ROP] 


* 

P0LI5T must specify one for each line 

STAPOL must specify one or more 

for each line* all STAPOL 
directives should be specified 
In the order in which stations 
are to be oolied 


Example I * 


STDLN 20,X'lrC0(y ,,2400,/M 

STD 20,I,,V7804 

ROP TN300 

STD 2 I,2*,V7304 

HOP ROSY26 

STD 22,3,,V7304 

POL 1ST 5 

STAPOL t,2,t,3 


In this example, an STD line ha s b e?n configured with three 
stations. As specified in the STDLN directive, this linens reouest 
level is 20, the channel number Is FCOO, the default modem used Is 
type 2, the line so^ed Is 2400 bits oer second, and the line 
connection is 4-wire. All three stations support VIP7804 terminals. 


I 
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2 The first station has an lrn of 20* a poll address of I, and 
i includes a IN300 R()P, The second station has an lrn of 21, a poll 

Q address of 2 and includes a PRU 1005 ROP, The third station has an 

^ lrn of 22* a poll address of 3 and no ROP, The POL I ST directive 

CO identifies the start of the poll list and specifies a 5—second delay 

between that the station with poll address I (lrn 20) is polled 
twice as often as the other two stations, inqplying that this station 
has higher priority. 

Example 2* 


STDLN !0,X y FF00 y ,2,2400,rt4 

STD 20,0,V7305 

HOP ROSY26 

STD 21,I,V7904 

STD 22,2 

POLI ST 2 

STAPOL 0,1,0,2 

DEVICE STDOO,20, 1 0,X' Fr* 00^ , V7805,SO,8 
DEVICE STD02, 21,1 0, X y FrOCK t V7804*80,B 
DEVICE STD03,22,l0,X y FF0CK,V7700,80,B 


the above example describes an J STD line connected to the system 
through address "FFOO**, with an interrupt level of 10* The line uses 
a type "2 M modem at 2400 baud and is a 4-wire connection. There are 
three VIP y s on the line*. The terminals will be polled in the 
following sequence for data< 0,l,0,2( after which there will be a 
delay of two seconds before they are oolled for data again. Address 
M 0 W well be polled twice as frequently as the other two terminals* 
All of the devices are configured for the file system, as shown in 
the DEVICE directives* (The DEVICE directives may appear anywehere 
in your CLM file). 
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STTY 


5TTY DIRECTIVE 


Directive Name* STTY 

The STTY directive specifies the file characteristics of a device 
that is not a disk device or a private device. The character!tics 
specified by this directive override the default characteritics 
established by the associated DEVICE directive Cor the 
characteristics established by a previous STTY directive). The STTY 
command keyword format (as described in Appendix D) may be used as 
an alternative to the STTY directive format in your CLM file. 


Format* 

S deviee.unit ( 

device.namea C lengthJ ,C D'dsw dsw * ], Cdetab!, [ in], 

tout] [.type] 


Argument Description* 

\device.unit) 
j de vice_name I 

This entry, which identifies the device, must be the same as one 
entered in a previous DEVICE directive. If device_name was specified 
in a previous DEVICE directive, it must be entered here! i.e., the 
entry of device.unit will result in error. The device_unit and 
device.name arguments each consists of a string of ASCII characters 
as described under the DEVICE directive. If there is no previous 
DEVICE directive having the string specified here, an error message 
is generated. 

[length J 

An Integer giving the line length (record size) In bytes. 


( I) 

You must use the STTY command format in your CLM directive file if 
you wish to configure a device that can be automatically 
reconnected if a oower resumption or line drop condition occurs. 
See Appendix D for information on how to configure devices as 
reconnectabie. The STTY co twiand format is described in Appendix D. 
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S- ED'dsw dsw '3 

i 2 

CO Specifies the terminal's device specific words for 

connect/disconnect (dsw!) and read/write (dsw2). The values of dswI 
and dsw2 are expressed in double-word format as a pair of 
4-character hexadecimal numbers enclosed in apostrophes. 

dswl specifies certain characteristics of a device at open (connect) 
or close (disconnect) time, as shown in Table 6-4 and 6-6. Refer to 
these table when defining the 16-bit settings for dswl that 
characterize connect/disconnect functions. 

dsw2 specifies certain characteristics of a device when reading or 
writing to a file, as shown in Table 6-5 and 6-6. Refer to these 
tables when defining the 16-bit settings for dsw2 that characterize 
read/write functions. 

If dswl and dsw2 are not soecifled, certain default values are 
assumed. Default values are listed in Table 6-7. 

NOTH* The STTY command keyword format (as described in Appendix D) 
may replace the STTY directive format in your CLM file. When 
used at CLM time, either STTY format will cause the initial 
dswl and dsw2 assignments (as well as the current device 
specific word assignments) to be modified. However, if the 
STTY command is specified at any time after system 
initialization, only the current device specific word 
assignments will be modified. Only at system building (CLM) 
time will the STTY directive format or the STTY command 
keyword format modify both the current and the initial device 
specific word assignments.(1) 

t detab] 

An alphabetic string that controls tabulation 

-ON Tab characters In the input stream are deleted and replaced by 
the number of spaces required to bring the cursor (or printer) 
to the next tab position. Tab positions are set by the MOD 400 
system In Increments of 10 (to print positions it, 21, 31,...) 
and cannot be changed by the user. 

-OFF Tab characters' in the input stream are not replaced by spaces. 


(I) 

In a diskette-based system, using the STTY command format in your 
CLM file results in the loader error 1609. If you wish to use the 
STTY command format in your CLM file, you must create a directory 
under the system root named SYSLIB2 and load In it the bound unit 
SSTY. 


6-66 




tin] 


An alphabetic character specifying the type of input accepted by the 
device. 

A - The device is to receive asynchronous input 

S - The device is to receive synchronous input 

N - The device is to receive nonbuffered synchronous input 

tout] 

An alphabetic character specifying the type of data transmitted by 
the device 

A - The device transmits asynchronous output 

S - The device transmits synchronous output 

N - The device transmits nonbuffered synchronous output 

f type 1 

An alphabetic character specifying the device type 
I - The device is an incut device 
0 - The device is an output device 

3 - The device is bidirectional* it receives and transmits 


Me ssa ?e s 


Error messages that may be issued during execution of this directive 


are as follows 

I33E CMD 
133F CMD 

1341 CMD 

1342 CMD 


(STTY) ERROR. 
(STTY) ERROR. 
(.STTY) ERROR. 
(STTY) ERROR. 


Mo previous DEVICE directive* 
Invalid detab argument* 
Invalid in or out argument. 
Invalid type argument. 


Device Specific rtords for Communications' Devices 

Table 6-4 list the bit settings for dswl. the device specific word 
for connect/disconnect functions! Table 6—5 lists the bit settings 
for d3w2. the device specific word for read/write functions. Use 
these tables in conjunction with Table 6-6 to determine the 
definitions of each bit. 

If you do not wish to specify dswl and/or dsw2 in the STTY 
directive, the system assumes certain default values for them. Refer 
to Table 6-7 for a list of device specific word defaults. 
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Table 6-4. Values for dswl 



LPH 0 I 2 3 4 5 A 7 8 9 10 IJ 12 13 


DISCONNECT TTY 0 O 0 0 0 0 0 0 0 0 0 0 0 0 

VIP 0 0 0 0 0 0 0 0 0 0 0 0 o 0 

esc o o a a o o o o o o o o o o 

PVE 0 0 0 O 0 0 0 0 •) 0 0 0 0 0 

ATD 0 0 0 0 0 0 0 0 0 0 0 0 0 0 

STD 0 0 0 0 0 0 0 0 0 0 0 C) 0 0 


Table -5-5. Values for dsw2 



LPH 0 1 2 3 4 5 6 7 3 9 10 W 12 13 14 


WRITE TTY 0 0 0 0 t) C) 0 0 0 0 0 L C 0 0 

VIP 0 0 0 0 0 0 0 0 0 0 0 L C 0 0 

BSC 0 0 0 0 0 0 0 0 0 G S V 1 * T 0 

PVE 0 0 0 0 0 O 0 0 0 0 0 0 0 0 0 

ATD h 0 0 1 X 0 1 Q 0 0 0 L C 0 0 

STD g 0 0 0 X 0 0 0 0 0 0 L C k k 
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Table 6-6. Bit Definitions 


BIT If bit * 0* 

A Dequeue remaining lORB's 
for channel 

a block mode not supported 
B Buffer mode is single-block 


o ETX mode (ATD Slock mode 
only) 

C Send OR after text of mes¬ 
sage fNot supported for 
sjoervisory message reads 
by ATD) 

c No soace suppress 
(VIP 7801) 

D No Au to-dia 1 u sed 


d Roll (VIP 7801) 

E Don't echc^ Input characters 

a No time-out for read 

r Don't save in read I ORB 
function codes received In 
text header 

f Don't abort read I ORB 
requests (ATD) 

J Use 3SC2780 orotocoi 

3 Don't abort read/write 
requests 

H Hang up the phone on 
disconnect 

h Don't abort write I0R8 

~ requests (ATD) 

I Control word present for 
read/write 


I f bl t * 1 * 

Don't dequeue remaining IORB's 
for channel 

ATD Block mode supported 

Buffer mode is double—block. 
(Note* Oouble-block Is not suo- 
ported by file manager) 

ET3/ETX specified on write (ATD 
Slock mode) 

Don't send CR after text of 
message 

Space suppress (VIP 7801) (Only 
applicable In block mode) 

Use Auto-dial handler to dial 
connection 

No roll (VIP 7801 ) ' 

Echo inout characters 

Time-out for read (immediate) 

Save up to 2 function codes 
received In text header 

Abort read IOR8 reouests (ATD) 

Use 3780 protocol 
Abort read/write requests 

Don't hang uo the phone on 
disconnect (ATD Block mode) 

Abort write I ORB reouests (ATD) 
No control word for read/write 




. Table 6-6 (Cont) c Bit Definitions 


BIT If bit * 0* 

1 Don't suoport preemptive 
write 

J Don't set VIP 7804 CRT 
space suppress 

j Send a block ended by ETX 

< Set VIP 7804 CRT roll mode 

L Don't send LF after text of 
message (Not supported for 
supervisory message reads 
by ATD) 

M Data mode is non-* 
transparent 

m Don't set BIP 7804 CRT to 
block mode (RECV) 

N Set transparent printer 
mode 

n Not reserved for cross¬ 
compatibility with STD Iph 

0 Quit on receiving break 
(Not supported for super¬ 
visory message writes by 
ATD) 

q Buffer mode is not multi¬ 
block 

S Don't send EOT characters 

s Don't suooort DLE EOT 

T Send ITB and ETB characters 

t Include control byte 

U Don't send DLE EOT for 
' VIP 7804 

u No echoplex (VIP 7801) 

V Don't send RVI characters 


If bit * I* 

Support preemptive write (ATD 
Block mode only) 

Set VIP 7804 CRT space suppress 

Send a block ended by ETB 
Don't set VIP 7804 CRT roll mode 
Send LF after text of message 

Data mode Is transparent 

Set VIP 7304 CRT to block mode 
(RECV) 

Set non-transoarent printer mode 

Reserved for cross-compatibility 
with STD Iph 

Don't quit on receiving break 

Buffer mode is multi-block 

Send EOT characters 
Support DLE EOT 
Send ETX characters 
Do not include control byte 
Send DLE EOT for VIP 7804 

Echoplex (VIP 7801) 

Send RVI characters 
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Table 6-6 (Cont). Bit Definitions 


Sit If bit * 0* If bit * J * 

v Include received DEL Strip received DEL characters 

characters in buffer 

ft Home cursor on page over- Don't home cursor on page 
flow overflow 

X Include control byte as No control byte (first byte is 

first byte data) 

1 Include ATTENTION character Exclude ATTENTION character 

y Return key equal transmit No specific meaning to return key 
key 

2 Transfer mode Is character Transfer mode is page 


k VIP 7304/5 Printer copy 

000 * i copy 010 * 3 copies 100 * 5 copies 110 * 7 copies 

001 * 2 copies Oil * 4 cooies 101 * 6 copies 111 ■ 8 copies 

P Logical Poll interval 

000 * 0 sec 010 * 2 sec 100 = 4 sec 110 * 15 sec 

001 * 1 sec Oil » 3 sec 101 * 5 sec III * 30 sec 

R Logical read time-out interval (poll duration) * 

00 » 10 min 01 * no time-out 10 * 0 min II * reserved for 

future use 

w # x LPH response to application when LPH receives data but no 
real IORB available* VIP status codes* 

00 * Send NAK 10 » Return busy status 

01 * Send ACK It * Send NAK (same as 00) 

NOTES* 

1. 0 indicates that you cannot use the bit. 

2. This table is organized by function for convenience only; 
there is no overlapping of bits, dswi sets ali bits for 
connect/disconnect functions. dsw2 sets all bits for 
read/write functions. 
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Table 6~7. System Defaults for dsw1 and dsw2 


Device 

dsw 

1 

dsw 

2 

. TTY 

0000 

0030 

VIP 

0000 

01 10 

ROP 

0000 

0000 

esc 

0000 

0000 

. PVE 

0000 

0000 

XBSC 

0000 

0040 

* ATD 

0000 

0030 

STD 

0103 

0010 
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TTY DIRECTIVE ( I) 


Directive Name* TTY 

The TTY directive identifies a station on a line serviced by the TTY 
(teleprinter) line protocol handler. The TTY directive suoports 
asynchronous terminal devices as teleprinter-compatible devices. You 
may float the channel assignment in this directive, if you wish. 


Format* 

TTY lrn,level ,X'channel',[modem3, Cspeed3 £ .'’device-type' 3 


Argument Description* 

lrn ~~ 

The logical resource number associated with the station. The value 
for lrn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 


( 1 ) 

The TTY directive and the ATD directive support asynchronous 
terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only in teleorinter mode. 
The TTY line orotocol handler does not orovide block mode support 
of VIP7300 devices; either does it provide support for VIP 7200 
devices and VIP 7300 devices in forms processing mode. (For these 
functions the ATD directive is reoulred).' The ATD line protocol 
handler does not provide the transparent read I/I) or single 
character mode functions of the TTY line protocol handler. The 
number of words of resident memory reoulred by the TTY line 
protocol handler Is less than the number of words of resident 
memory required by the ATD line protocol handler. See the MOD 400 
Executive Software Release Bulletin for comparative figures. 
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level 

The priority level at which the communications supervisor processes 
requests for an input/output operation to the station. The value of 
level is an integer from 7 through 6If it may be the same as the 
level specified for other communications stations* but it must be a 
higher number than the communications Interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks, 

X'channel-^ 

You may specify a single zero(O) to float the channel number 
assignment or a four-digit hexadecimal number (from X-'CMOn' to 
X'FFBn-'), that specifies the channel number of the station and the 
interrupt priority level (n) of the line. The channel number has 
the following format* 

Bit 0 through 9 * The 10-bit channel address of the send or 

receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which a 

communications line interrupts the centra1 
processor, n may have a value of 0, I, 2, or 3 
as specified in the COMM directive. See the 
description of the C() M M directive for further 
information* 


C modem! 

A number specifying the type of data set. Possible values are as 
follows s 

0 - Direct connect, 

I - Bell 1xx-type modem (1G3A, etc.). Both data-set-ready and 

carrier—detect signals are required for a connection* absence of 
these signals is a disconnection. 

3 or greater — User-defined modem type (see “MODEM Directive", 

earlier in this section). 

The default value is modem type 1. 
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C speed] 

The data rate Is bits per second. 

For an asynchronous line with a communications-pac whose id Is 
2I08(16), use one of the following values for speed* 


(default) 


50 

300 

2400 

75 

600 

3600 

110 

900 

4800 

134 

1200 

7200 

150 

1800 

9600 


For an asynchronous line with a communications-pac whose id is 
2100(16), 2110(16), or 2118(16), use one of the following values for 
sp eed * 


50 

75 

(default) 110 
134 
150 

NOTE* If the data rate 

You have the ootion to 
terminal comes online, 
Lo, 


200 

1800 

300 

2000 

600 

2400 

050 

4800 

200 

9600 


is 134.5, specify 134, 

defer selection of the 
You select this option 


line speed until the 
by specifying HI or 


'HI' 


Soecifles that all terminals associated with this line will be 
permitted to function only at soeeds from 1200 through 9600 
bits per second. 


'LO' 


Specifies that all terminals associated with this line will be 
permitted to function only at speeds from 110 through 1200 bits 
per second. 

For more information about the line soeed selection capability, 
refer to the discussion under “Topics Related to CLM Directives" 
near the beginning of this section. 
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AIL 


['device-type'] 

Specifies the type of terminal used* If this argument is not 
specified* the default is TTY * Possible values are* 

Value Physical devices supported 

7200 VIP 7200, VIP 7205 

7801 VIP 7801, VIP 7802 

f 

PRU PRU 1001, PRU 1003, PRU 1005, 

TWU 1001, TVIU 1003; TVfU 1005 

TTY An asynchronous terminal that 

is to be supported as teleprinter- 
compatible. 


Example 1 * 

TTY 21,8, X'FFSO' 

DEVICE TTY01,21,8,X'FF80', TTY I 

In this example, the TTY is connected by a Bell lxx-type modem end 
operates at 110 bits per second. Default values for modem type and 
line speed have been used. The TTY is to be accessible through the 
file system Interface (by virtue of the DEVICE directive). 

Example 2* 

TTY 22,8,X'FFO0',O,1200 
DEVICE ■ TTYO2,22,8,X'FF0O',TTY2 

In this example, the TTY Is connected by a direct cable connection 
and operates at 1200 bits oer second. These characteristics are 
reflected by explicit arguments in the TTY directive. Again, the TTY 
to be accessible through the file system interface. 
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VDAM 


Directive Name* VDAM 

The VDAM directive must be specified if the Disoiay Formatting and 
Control software is to be used. This directive causes the software 
component to be incorporated In the configuration 1). You must 
configure the Display Formatting and Control Sofware if your 
installation will suoport DEF-II or DEF—II and TCLF. See Appendix P 
for further information on configuring the Display Formatting and 
Control Software. 


Format * 

VDAM _lrn,level]C,maximum terminals! 


Argument Description* 

Irn 

The logical resource number associated with the VDAM task. The value 
for lrn is an integer from 3 through 255. This value must be 
specified if asynchronous VDAM processing is desired. The next two 
sequential lrns will be reserved for VDAM processing. 

Level 

The priority level at which VDAM processing ooerates. The value for 
level must be an Integer from 7 through A!. This value must be 
specified if asynchronous VDAM processing is desired. 

NOTE* doth irn and level must be specified, or neither argument 

should be specified. If neither one Is specified, the default 
. is that not asynchronous Instructions are issued to VDAM. 

Cmaximum terminal] 

The maximum number of terminals that use VDAM processing in one task 
grouo. If a number is not specified, the default value Is 10. 

NOTE* When using VQAM with Block Mode Terminals l.e. OKU 7005 or OKU 
7007 (configured using an STD directive) another bound unit 
must be loaded via* 

LDBU 2NV77F 


I 

Display processing requires VIP 7200/7205 or VIP 7301/7802 
terminals. The terminals can be configured using an ATD or a V7200 
directive. 
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VIP DIRECTIVE 


Directive Name* VIP 

The VIP directive Identifies a polled or nonpolled visual 
information projection station on a line serviced by the VIP line 
oretocol handler* Optionally* the VIP directive Identifies a ROP 
(recei ve-only orinter) station on the same line* Cl*2,3*4) VIP 7700, 
VIP 7700R/7705R, VIP 7804/7805 (in VIP7700 mode) and VIP 7740 
terminals are supported. You may float channel assignments in this 
directive, if you wish. 


Format * 


VIP lrn,leva 1,X'channe1*,tmodemJ*Cooll.address1 * 
CROP_lrn] t CROP.,type] [ ,ROP_form.feed J 



(1) 

The VIP directive and the STD directive both support synchronous 
terminals. The line protocol handler called by the STD directive 
offers additional support caoabilities (e.g** support of VIP7804 
and VIP7805 terminals) not offered by the line protocol handler 
called by the VIP directive. 

( 2 ) 

If the Configuration Load Manager detects an error in a VIP 
directive, the error must be connected in the CLM-USER file and the 
system bootstrapped again. 

( 3 ) 

If the station is to be accessible through the file system 
interface, an aopropriate DEVICE directive must be "paired" with 
the VIP directive (see "DEVICE Directive", earlier in this 
section). 

(4) 

If a "remote" system is to perform Dolled VIP emulation, see "PVE 
Directive", earlier In this section, for a description of the 
relationshio between VIP directives for the "local" system and PVE 
directives for the "remote* system. 
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Argument Description* 
lrn 



The logical resource, number associated with the station. The value 
for lrn is an integer from 3 through 255. A program may use this 
number to Identify the station when It requests an lnput/outout 
operation to the station. 

level 

The priority level at which the communications supervisor Drocesses 
requests for an input/output operation to the station. The value for 
level is an integer from 7 through hii it may be the same as the 
level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 

The level for all oolied VIP's on a common MLCP channel must be the 
same. 

X'channel 

You may specify a single zero (0) to float this channel assignment 
or a four-digit hexadecimal number (from X'040n' to X'FFSn'), that 
specifies the channel number of the station and the interrupt 
ortiority level <n) of the line. The channel number has the 
following format* 

Bits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n* the priority level at which a 

communications line interrupts the central 
processor, n may have a value of 0, 1* 2, or 3 
as specified in the COMM directive. See the 
descriotion of the COMM directive for further 
Information. 


[modem] 

A number specifying the tyoe of data set. Possible values are as 
follows * 

0 - Oirect connect. 

2 - dell 2xx-type modem (20IA, 208B, etc.). The data-set-ready 

signal is needed for a connection! absence of this signal is a 
disconnection. 
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X. 3 or greater - User-defined modem tyoe (see “MODEM Directive", 
^ earlier in this section). 

The default value Is mode type 2. 


Cpoll_address3 

Specifies the address of the VIP station on the line specified by 
the channel argument* The value for ooll_address is an integer from 
0 through 3J. If no polling address Is specified* no polling can 
occur on the line? in this case* only one VIP station can be on the 
line* 

[fii] 

This argument is meaningful in only two situations* 

(1) a file-transmission (nonpolled) environment and 

(2) a nonpolled environment wherein the VIP Is to be accessible 
through the file system Interface. (In the second situation, the VIP 
directive must be "paired" with an appropriate DEVICE directive). 

C specifies that the central processor Is the control station; T 
specifies that the central processor is the tributary station. The 
tributary station must send the first 0 (quiescent) frame on the 
line. The default value is C« 


(In the nonpolled, file system aocess environment, T should be 
specified In the VIP directive In order to avoid excessive delays in 
Input/output ooeratlons)* 

CROP_lrnJ 

Specified the logical resource number of a recelve-only Drinter 
connected to the VIP controller. The value for Rv)P„lrn is an integer 
from 3 through 252. The default is that no receive-only printer is 
connected to the VIP controller; in this case, the R()P_type and 
POP_fortrufeed arguments must not be specified. 

C R()P„type 3 

Specifies the type of receive-only printer. Chnose from one of the 

followin3 * 


Rop^type 


Corresponding 
device_type 


TN3QO (default) 
TN1200 
TTY 33 
TTY 3 5 


TermINet 300 or PRUI003 
TermiMet 1200 or PRUIQ05 
A SR-33 
ASR-35 
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C ROP_form_f eedj 


Specifies whether the receive-only printer has a form-feed ootion. 
FORM or Ft) indicates that the receive_only_orinter does have the 
form.feed option* NOFORM or NO indicates that it does not have the 
form.feed option* 

• 

The default is that TermiNets have the form.feed option and the 
TTY's do not have the form.feed option. 

NOTH* The following rules only to lines that have more than one VIP 
station (l.e.* a polled VIP environment)* 

(1) a separate VIP directive is reauired for each station on 
the line* 

(2) the VIP directives be consecutive, and 

(3) the logical resource numbers of the stations on the line 
must be consecutive. 

Examoles* 

In the following examples, VIP stations are connected by 3ell 
2xx-type modems* Default values for modem tyoe have been used. 

DEVICE directives are "oaired" with the VIP directives because the 
VIP's are to be accessible through the file system interface. 

Examole It 

VIP 23*8,X'FE80' ,,0 

DEVICE VIP00,23,8,X'FE80',VIPO 
In this examole, the VIP has a poll.address of 0. 

Example 2* 

VIP 24*3.X'rE80'.,I,,25,TNI200 
DEVICE VIPOI,24,,8,X'FE80',VIPJ 
DEVICE ROPOI,25,3,X'FE80',ROPI 

In this example, the VIP has a ooll.address of I. In addition to the 
.VIP screen* the VIP controller has a TermiNet 1200 as a receive-only 
printer. The VIP screen's logical resource number is 24 and the 
receive-only printer's logical resource number is- 25. 




VROSY/\nTY/V7200 

VROSY, VTTY, AND Y72Q0 DIRECTIVES Cl), (2) 


Directive Name* VROSY, VTTY, or V7200 

These diretives define devices that are on lines serviced by the ATD 
line protocol handler Except for the directive name* the format is 
the same for ell three directives. You can float channel assignments 
in these directives. 


Format t 

( VROSY ) 

^ VTTY / Irn,level,X'channel',[modem 3,Cspeed 3,[device_type3, 

(V7200) (dell, Cstop_bi 13 [.parity] 


Argument Description! 

Irn 

The logical resource number associated with the station. The value 
for irn is an integer from 3 through 255. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 


Cl) 

The ATD directive intended as a remplacement for the VROSY, VTTY, 
and V72QG directives. The line protocol handler called by the ATD 
directle offers additional supoort capabilities (e.g., block mode 
support of VXP7801/7802 devices, support of the VIP7207 device) not 
V720Q directives . The VROSY, VTTY, and V7200 directives can still 
be used. The directives, however, call the ATD line protocol 
handler. 

< 2 ) 

The ATD directive or the 7200 directive must be specified if 
VIP7200/7205 or VIP7801/7802 terminals are to be used for forms 
processing using HONEYWELL'S Display Formatting and Control 
Facility. The VIP 7200 line protocol handler “nonforms mode** is not 
suooorted by ATD. The equivalent functions can be obtained by using 
the forms mode with a form defined as fully unorotected. 


I 
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level 


The priority level at which the communications supervisor processes 
requests for an input/output operation to the station. The value 
for level is an integer from 7 through 6li it may be same as the 
level specified for other communications stations, but it must be a 
higher number than the communications interrupt level(s) specified 
in the COMM directive. The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 

X'channel' 

You may soecify a single zero (0) to float this channel assignment 
or a four-digit hexadecimal number (from X y 04On' to X 7 rF8n'), that 
specifies the channaL number of the station and the inetrruot 
priority level (n) of the line. The channel number has the 
following format * 

Bits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

31ts 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which a 

communications line Interruots the centra 1 
processor, n may have a value of 0, I. 2, or 3 
as specified in the COMM directive. See the 
description of the C() M M directive for further 
information. 

C modem] 

A number soecifying the type of data set. Possible values are as 
follows * 

0 - Direct connect. 

1 - dell 1xx-type modem (103A, etc.). Both data-set-ready and 

carrier-detect signals are required for a connection; absence of 
these signals is a disconnection. 

3 or greater - Use.r-deflned modem type (see "MODEM Directive", 

earlier in this section). 

The default value Is modem type I. 
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VROSY/VTTY/V7200 


t speed3 

The data rate In bits per second* 

For an asynchronous line with a eomraunic«tions—pac whose id is 
2108(16), use one of the following values for speed* 


50 

* ~ ~ ^ - -’y 

300 

2400 

75 

600 

3600 

(default) 110 

900 

4300 

134 

1200 

7200 

150 

1800 

9600 


For an asynhrenous line with a eommunications-pse whose id is 
2I00CJ6), 211006), or 241806), use one of the following values for 
speed* 


50 

200 

1800 

75 

300 

2000 

(default) 110 

600 

2400 

134 

1050 

4800 

150 

1200 

9600 

In VTTY or V7200 directives. 

you have 

the option to defer selection 


of the line speed until the terminal comes on-line. You select this 
option by specifying HI or L(>« 

'HI' 

Specifies that all terminals associated with this line will be 
permitted to function only at speeds from 1200 through 9600 
bits per second. 

'ho* 


Specifies that all terminals associated with this line will be 
oermitted to function only at speeds from 110 through 1200 bits 
per second. 

For more information about tine line speed selection capability, 
refer to the discussion under H Topies Related to CLM Directives' 1 
near the beginning of this section. 


6-84 



Ida vice., type] 

Specifies the type of terminal used. The allowable types and the 
default for each directive are as follows* 


Directive 

Devices supported 

device_type 

V7200 

VIP 7200, VIP 7205 

7200 


VIP 7801, VIP 7802 

7801 

VROSY 

PRU 100), PRU 1003, PRO t005, 

TWU 100), TWO 1003, TWU 1005 

PRU 

VTTY 

An asynchronous terminal that 
is to be supported as 
teleprinter-compatible 

TTY 

[dell 




In the TTY mode, a head-of-forra sequence (pre-order control) 
consisting of three LF's and the number of DEL characters specified 
by this argument Is generated If. the following conditions are met, 
(If the conditions are not met, no head^f-form sequence is 
generated). 

• The first byte of the application's buffer must be designated 
as a control byte* i,e*, bit 4 of the lORB's device specific 
word (I_DVS) must be set to 0 at write time, 

• The control byte roust specify that a head-of-form sequence is 
to be generated* l,e., bit 3 of the control byte must be set 
to I, 

, Device type PRU is not specified. If it is specified, a true 
head-of-form is issued. 

In the field of. TTY modes, an LF in an end-of-message sequence (post 
order control) is followed by the number of DEL characters specified 
by this control argument. 

The EOM sequence is controlled by the B- and C-bits of the IORB's 
device specific word I_DVS, as specified by the application at write 
time. The TTY line protocol handler sends an EOM sequence according 
to the following B- and C-bit values, 

IJ5VS Bits 

B C EOM Sequence 

0 0 OR 

0 I None 

I 0 CR,Lr,DEL characters 

I ) LF,DEL characters 
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VROSY/VI IY/V/2UU 


At read time, the application can specify the same B~ and C*» bit 
values in order to send an EOM sequence back to the terminal when 
the message is successfully received. 

Mote that an LF character in a pre-order control specified by the 
I-CoN word of an IORB is never followed by a DEL character* i.e., 
this control argument has no effect in this case. 

This argument allows you to select t to 32 DEL characters* The 
default for each type of device is as follows* 


device type 
7200 


Number of DEL characters 


780) 


istop_bit] 

Specifies the number of stop bits that are to follow each character. 
A value of ! or 2 can be cnosen for each device. Default val^jes are 
as follows* 

Number of Stop Bits 
1 

(for soeeds greater 
than HO bits per 
second) 

2 

(For a speed of 110 
bits per second or 
less) 

Cparlty 1 

Specifies the type of parity (enter ODD or EVEN) to be used. The 
default is EVEN. 


8b 
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SECTION VII 

MOO 400/MFS PROGRAM MATERIALS AND DISTRIBUTION MEDIA 


A listing of MOD 400/MFS program materials Is provided In Figures 
7-1 through 7-19. Figure 7-1 lists the program materials made 
available with the MOD 400/MFS Executive. Figures 7-2 through 7-19 
list the program materials made available with the various 
separately-priced products that can be used with the MOD <*00/MFS 
Executive. Order numbers for these products are also provided. 

MOD 400/MpS software Is available on the following media* 

. Cartridge Disk 
. Cartridge Module Disk 
. Mass. Storage Unit 
* Diskettes 

MOD 400/MFS Executive software can be distributed on a Mini 
Cartridge disk C''ZSYSA2), two cartridge disks (SYS51 and ~ZSYS52), 
a single cartridge module disk ('''ZSYSAl), or on a single mass 
storage unit (*ZSYS7l). If an installation orders any of the 
separateiy-orlced oroducts, appropriate modules are added to A ZSYS51 
and "*ZSYS52, ~ZSYS6I, ~ZSYS62, or ^ZSYSTI, or they are provided on 
separate diskettes. 

MOO 400/MFS Executive software is made available on up to five 
diskettes (^ZSYSOO, ~ZSYSOA, ~ZSYSIA, ~ZSYS13). The software will be 
packaged to make most effective use of the distribution media. 
Software will be packaged uo on to five diskettes if the user 
receives the software on single-sided diskettes. If the user 
submits diskettes with a larger capacity, then fewer diskettes are 
requt red. 

Users oerforming system installation with CII HONEYWELL 
3ULL-suDplied distribution media should note the following* 

. If the MOD 400/MFS Executive was distributed on a Mini 

Cartridge disk, cartridge disks, a cartridge module disk, or a 
mass storage unit, then all Executive modules will be present 
on the volume!s>. 

. If the MOD 400/MFS Executive was distributed on multiple 
diskettes, then each diskette will contain a subset of the 
total number of Executive modules. The diskette labeled ''ZSYSOO 
must be used as the bootstrap volume at initial system startup. 
The user must be aware, however, that ‘"ZSYSOO well! not contain 
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sufficient software to oermit use of the full range of MOO 
400/MrS functionality. Once the user attains the limited 
processing environment permitted with “‘ZSYSOO, then the user 
should examine the contents of the other diskettes and delete 
and transfer software modules as desired. The user can consult 
Figure 7-1 to identify Executive modules required for various 
MOD 400/ MpS functions. 

In Figures 7-1 through 7-ld, elements enclosed within boxes are file 
ystem directories* Other elements are files.Cl) Indentation 
ignifies subordination - that is, all files described in a given 
irectory are indented from the margin of the boxed directory name. 
In a few instances, one directory is shown to be subordinate to 
another directory* again. Indentation is used to signify this 
relationship. 


SOFTWAaE TO 35 PLACED ON THE BOOTSTRAP VOLUME 


Certain modules must be present on the bootstrao volume in order to 
achieve system startuo. Other modules must be present on the 
bootserao volume if certain tyoes of processing are to be suoDorted. 
These required modules are described in the following diagrams. 


< l) 

Note that in some cases files are immediately subordinate to the 
volume root directory. 
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Z3EXECUTIVES 

K 

SAF system executive* required 

U 

Z3EXECUTIVEL 

LAF system executive* required 

START_UP.EC 

File used with CLM_US£Rt required 

GROUPSH.EC 

EC file to spawn sH task group 

GROUPS?.EC 

EC file to spawn $P task group 

SUPER.EC 

EC file required for a dual-purpose operator 
terminal 

GROJPSD.EC 

EC file to spawn $D task group 

DEBUG.WORK 

Work file for $D DEBUG 

DE3UGD8 

Lead task of $D DEBUG utility 

jRECOVERVl 

File recovery 

FILES 

GROUPS 

• 

IhTs] 


START-UP.EC 

File used for $H task group* required if 
CLM.MDC or CLM_MCP used 

§50 


EMLFILE 

Error message library 

|mdd| 


SPR.02 

mailbox oueue 

SPR.Q3 

mailbox Queue 


IuBdI 

REPORTS 


L 00 


OBJECT 


EXECUTI VEl 

ZIMLCC.O 

ZGQIS8.0 


Figure 7-J. MOD 400 Executive Program Materials 
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INCLUDE 


CCP_MAC.IN.A 
MGIR8.I N.C 
MG3R8.C 
MGCRB.C 

uni 

START_UP.EC 

CL ^SAMPLE 
CIPSIM 
1/ CLM 
CLMCM1 
CLMCM2 
CLMCM3 
CLMCM4 
/ CLMCOM 
^ CLMDEV 
CLMFLT 
LCLMMMU 
u CLMLHQ 
^ CLMMAP 
^ CLMSTI 
t/CLM5T2 
L-CLMST3 
^'CLMVAR 
Re 50 LA 


File used with CLM.MDC or CLM_MCP* required 
onlu if either is oresent 

Sample CLM file* opt Iona 1 

Commercial simulator 

Configuration Load Manager* reauired X 
CLM functions* required \ 

CLM functions* reauired \ 

CLM functions; required 
CLM functions* renuired 
CLM functions* required 
CLM functions* reauired 
CLM functions* required 
CLM functions * reouired 
CLM functions* required 
CLM functions * required X 
CLM tablest required 
CLM tablest required ^ 

CLM tables * reauired 
CLM functions* required 

c 

Makes all Executive overlays resident* ootlonal 



Figure 7-1 (Cont). MOD 400 Executive Program Materials 
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ROLLCD 


SIPSIM 

SIPSIM.SP 

VLOCD 

ZE.RRST 
^ZC'JCQS V 
Z3SACU 
ZCESSL 

^zosxec x 

ZQHLPH 

^zqpatd / 

ZJPORT 

ZXPfR 

ZQPTTY 

Z3PVIP 

ZCriCI 

^ZCTOUM / 
ZJTRAX 
ZXOEFM 
Z3ECPJ 
ZQPATC 


CLM code for rollout function! required only 
If rollout capability is configured 

c 

Single/Double Precision SIP Simulator 

c 

Single Precision SIP Simulator 

CLM code for MMU functions! required only if 
MMU present 

c 

Error statistics module! optional 

c 

CLM communications module 
Auto Call module! optional 

c 

Speed select module! optional 

c 

Communications supervisor 

Communications HASP line orotocoi handler! 
optional c 

Communications asynchronous terminal line 
protocol handler! ootional c 

Communications synchronous terminal line 
protocol handler! optional c 

c 

Power Resumotion Facility* optional 

c 

Communications TTY line protocol handler 

c 

Communications VIP line orotocoi handler 


Communications PCI line protocol handler; 
optional c 


Required for a communications configuration 

c 

Internal Diagnostic Trace Capability 

c 

Defective Memory Trao Handler 

< 

Auto Call channel control program! optional 


ATD channel control program! ootional 


-Figure 7-1 (Cont). MOD 400 Executive Program_Mater.la.is- 
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Z3PCCP 

Z1PTC? 

Z1PPVE 

ZOPACT 

ZQPACC 

ZJPPRT 

ZOPSDG 

zap5UR 

zaxv'ip 

zaxpvE 

ZJX3SC 

Z3X p BS 

zaxAiro 

Z3XTTY 

ZJXCRT 

ZOXXEC 

CL4JKCP 


CLM„MDC 


SYSLIfl 


cso 


STD channel control program* optional 

c 

TTY channel control orograra* optional 

ACTD asynchronous LPH 
ACTD channel control program 
Printer management 
Badge management 

common subroutines to ZOPPRT and ZQPBDG 


File of CLM directives used during stage I 
system startup with MLCP/DLCP-connected 
operator terminalt required If your installation 
has an MLCP/DLCP-coonected operator terminal. 

File of CLM directives used durina stage t 
system startuo with MDC-connected operator 
terminals required if your installation has 
an MDC-connected operator terminal. ! 


Execution command used for EC files; reauired 
if any START„UP.EC file used 

Change system directory ooerator command* 
required 


Figure 7—1 (Cont). MOD 400 Executive Program Materials 
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SYSLIS2 


ABORT.BATCH 

' DP 

AB OR T — GROUP 

DPEDIT 

ABP 

DPN 

ABR 

DT 

ACTS 

EBR 

ACTS 

d 

AGR 

EC 

A MM 

EGR 

AMT 

EQUAL 

BYE 

ETR 

CB 

FO 

CG 

LISTENER 

CORO 

LOAD 

CMBX 

LQR 

CQR 

LSR 

CT 

MAIL 

CVD 

MSG 

D8 

MSN 

DEBUG 

NEN.PROC 

DEL.CUM 

NOW 

DG 

OPcR 

DMNC 

PR.ELiXJ 

DM ON 

PR_CUM 

ZELUPD 

□BP 

ZXL!X3 

DCA 

ASSOC 

DO 

BC 

DISSOC 

BP I 

DL 

BPS 

DX 

CBP 

ED 

CD 

EX_PAM 

CH 

FC 

CiCMSV 

FCDS 

CKP THILs 

FD 

CMR 

FDDE 

CP 

GET 

CPA 

GQ 

CPAS 

IM_PAM 

CPADE 

ISLCON 

cpoe 

IT 

CPR 

PX 

CR 

RX 

d 

LA 

CSD 

LCA 

CV 

LCD 

CVCY 

HD 

CVUE 

LINKER 

d 

LMR 

CWO 

LS 

CX 

LSDE 

DA 



Hiaura 7-J (Cont). MOD 


PR.HOLD 

QUERY 

RDF 

RON 

RESTART 

SO 

SET.ELOG 

SET^LISTEN 

SO 

SMM 

SSPB 

SSRO 

ST 

START.ELOD 
START.MAIL , 
STG 

STOPPED W 

STS 

TIME 

UNLD 

UPO.CUM 

USER 

LTC 

LNO 

LX 

M4_5YSDEr 

MFA 

PATCH 

PR 

PR.UK 

QRPT 

RECOVER 

REMOVE 

RESTORE 

RL 

RN 

ROM 

SA 

SAVE 

SCA 

SDL 

SIT/ 

TPOS 

UNSP 

VALIOCKPT 

WH 

MS 

D.MdX 


Executive Program Materials 
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FORMS 


TV 

|TV | (cont.) 

PROGS 

VDAM.rORMOl 

CDUGI 

MT9G1 


RDfT 

01 MG 1 
PRMGI 
TCSG1 

MT7GI 

ZTVM 

.ZTVIOO 

TRANS 


a 

Present only on SAF medium 


b 

Present only on LA*- medium 


If the system is to include this caoability, this system software 
must be present on the bootstrap volume before configuration. 

NOTE* Software modules listed as being optional may be Judiciously 
deleted if the user does not wish to configure a particular 
capability* otherwise, the aoorooriate software modules musi 
be included with the Executive software if the user wishes to 
configure an optional capability. 


d 

Required for Stage I and Stage 2 system startup. 


Figure 7-1 CCont). MOO 400/MrS Executive Program Materials 






ASScM 


MACHOP 
[LDP 


OBJECT 


SXECUTIVE 


ZGQISB.O 

ZIMLCC.O 


MACRO 


EXEC.UB 


macro routines 
IXNP.USER 


macro routines 


figure 7-2. Assembler/Macro Preprocessor Program Materials (SHL937) 



Figure 7-3. FORTRAN Program Materials (SHL936) 


PYSLI32I 

RPG 

AUTO 

AJTUR 

Figure 7-4, RPG Program Materials (SHL92A) 
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SORT 


SOftlC 

MERGE 

Figure 7-5. SORT/MERGE Program Materials (SHF9J0) 



ZGP85C 

I 

ZQHLPH 

ZGPPBS 

[syssYdil 

TftANB 

1 

These program materials must be transferred to the bootstrap volume 
be fore confioura tion„ 

Figure 7-^. File Transmission (Non-HONEYWELL Host) (SHC953) 

SYSLIB2 \ " ' 

COdoLI (intermediate level) 

unm z■ 

object modules 

Figure 7-7. Intermediate COBOL Program Materials (SHL925) 

ZDRT 

Ocr_SAMPLE.S 

object modules 

Figure 7—8. DEF-I Program Materials (SHC917) 


I 
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SYSLI B2 ! 


■ - - * 

R8T 

Figure 7-9. RBF/66 Program Materials (SHC9I5) 

fsTo! [SYSLIB21 

- 1 

ZQPPVE TRAN 

i 

ZQRCI 


1 

These program materials must be transferred to the bootstrap volume 
before configuration. 


Figure 7-10. File Transmission <CII HONEYWELL BULL Host) Program 

Materials (SHC951) 


|3YSLI32 


HASP 



Figure 7-n. HASP Workstation Facility Program Materials (SHC959) 


SY5LI32 
W 32 780 
W33730 

Figure 7-12. 2730/3730 Workstation Facility Program Materials 

(SHC958) 









1 



2QPP3S 
|~5YSL 132 [ 
trJ271 

4 

2r'32 IN 
2C08Ir*0 

* 

. These program materials must be transferred to the bootstrap volume 
before confIguratioru 

Figure 7—13^ Programmable Faelllty/3271 Program Materials (SHC988) 



Figure 7-14* TCLF Program Materials (SHS94I) 


SY5LI32| 

FORTRANA 

iZFIRT 

runtime routines 


Figure 7-J5* Advanced FORTRAN Program Materials (SHL944) 
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Figure 7-16. SASIC Program Materials (SHL942) Interpreter, <SHL943) 
Interpreter/Compiler, (SHL932) runtimes 


3YSLIS2 


O'lr 

DerCMPL 

DErEXEC 

QZrrlG 

DEFPRNT 

DEFSTA 

DerSPcC 

DEFSUPS 

DEFXFER 


OErMEMU 


JEF-II system forms 


Figure 7-17. DEr-II Program .Materials (SHC989) 


SYSLI32 


COdJLA 


; ZC ART 


ob jec t modules 


Figure 7-l8. Advanced COBOL Program Materials (SHL945) 
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FORMS 


ZQQMNT 
ZOOOPR 
ZOOSTA 
ZQDBYE 
ZQOSTft 
ZQDSND 

User-written TBUs 


| ZQ03CFI 

ZODATD 

ZQDDMP 

ZQDOUM 

ZODFrfK 

ZQDINI 

ZQDiOC 

ZQOISN 

ZOOIOI 

ZOO 102 

ZOOJ35 

ZODLST 

ZOOMIS 

ZOOOIM 

ZQOPAI 

ZODPRM 

ZQOPVE 

ZQORES 

ZQ03CH 

ZOOSTD 

ZQOSUB 

ZQOTCL 

ZODTSK 

ZQOTSV 

ZQQTTY 

ZQQTU I 

ZQ0T02 

ZQDT72 

ZOUOVL 

ZQOUSN 

ZQOUTR 


DTFF 


INCLUDE 


8CFMAC,IN e A 


BCFWRKi 


BCFGENl 


BCFGEN.EC 

User-written BCF generation 


Figure 7~19* BCF Program Materials (SHC987) 
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Z3D3YE 

ZQOdCr 

Z0003G 

ZQOMNT 

ZQOSNO 

ZQOSTA 
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ZQOORR 


ZOOAID 

ZUQO.MP 

ZQQOUM 

ZQJrWK 

ZOOIN I 

ZOOIOC 

ZQOISN 

ZOOIO) 

ZOOI02 

ZOOJ35 

ZOOLST 

ZOOMIS 

ZOOOIM 

ZQDPAI 

ZQDPRM 

ZQDPVE 

ZQDRES 

ZOOSCH 

ZOOSTO 

zaosua 

ZQOTCL 
ZQOTSK 
ZQOTSV 
ZOO TTY 
zaoroi 
ZOOS02 
ZQOT72 
ZQOOVL 
ZDOUSN 
ZQDUTR 
ZQOATL 
Z000NX 
ZOOSYX 
ZQOOrF 
ZQOSTY 
ZODSPJ 
Z0D7VU 
ZQJpIL 
ZOOOFB 


ZQDBYE 

ZQDBCF 

ZODOBG 

ZQDMNT 

ZQDSND 

ZQDSTA 


FORMS 


DTFF 


INCLUDE 


DRRMAC.IN.A 


DRRWRK 


ORRGEN 


DRRGEN.EC 

DRR.P 


0RRT3U 


COBTBU.EC 

TBU 


TBUn 


Figure 7—21. DIF With Restart/Recovery Program Materials (SHC936) 


7-17 





Figure 7-“ 22® Program Materials For Remote Batch 64/DPS (SHC954) 




Figure 7-24® Program Materials For Display Formatting and Control 

C SHC96I) 


7-13 


I 











SECTION VIII 
TECHNICAL NOTES 


This section describes a number of miscellaneous tooics, most of 
which pertain only to certain Installation sites. Before attempting 
any use of the system, you should ascertain which of these topics 
apply to your installation and oroceed accordingly. The following 
topics are described* 

,__CSD (Change System Directory) operator commands in START_UP.EC 
file for system task group 

. Transferring the contents of “*Z5YS51 or **ZSYS6I to the fixed 
platter of a two-platter drive 

. Svystem search rules and the system commands 

. Procedure for transferring software modules 


CSP OPERATOR COMMANDS IN START_UP.SC FILE OP SYSTEM TASK GROUP 


If a START_UP.EC file is used for the system task grouo during a 
stage 3 system startup <l), it must be immediately subordinate to 
the root directory of the bootstrao volume. This START_UP.EC file 
should contain one or more CSD (Change System Directory) operator 
commands to reassign the system libraries -LIBL and -LLB2. away from 
their defaults (the default assignment fo both -LIBI and -LIS2 is 
SYSLIdl on the bootstrap volume). 

[f the system is to be bootstrapped from a non-diskette volume, the 
START_UP.EC file for the system task group should contain the 
following two CSD operator commands (in addition to any other 
appropriate operator commands)* 

CSD -LIS( pathname_to_user-library 

CSD -LIB2 >SY$LIB2 


( I) 

The stages of system startup are described in Section III. 
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These operator commands will appropriately specialize the systems 
search rules for this environment. When the system's loader seeks a 
bound unit to be loaded, it will first search the user's working 
directory (default), then (if necessary) the user_library (-LIBJ), 
then (if necessary) SYSLIB2 on the bootstrap volume ( —LIB2). 

If the system is to be bootstrapped from diskette (*ZSYSOO), the 
iTART^JP.EC file for the system task group should contain the 
following CSD operator command* 

CSD -LIB I ~ZSYSOOSYSUBJ 

This operator command will appropriately specialize the system's 
search rules for a diskette environment. When the system's loader 
seeks a bound unit to be loaded, it will first search the user's 
working directory (default), then (if necessary) ''ZSYSO1 >SYSLIB1 
(-LI31). Typically, in a diskette environment, the ooerator uses 
dynamic CSD operator commands to assign -LIB2 to the pathname that 
will be searched (If necessary) following '"'ZSYSOJ >SYSLI81 * 


TRANSFERRING CONTENTS OF *ZSVS5I OR *ZSYS6I TO FIXED PLATTER 


if your system is cartridge-disk-based or 

cartridge-module—disk-based, you may wish to copy the contents of 
your system volume to the fixed planter of a two-platter drive. The 
original HONEYWELL-supplied system volume may then be dismounted and 
saved as backup. The following procedure is recommended.(I) 

1. Mount system volume '“ZSYS5I on RCDOO, or mount system volume 
~ZSYS61 on RCMOO. 

2. Perform a stage 2 system startup, bootstrapping the system 
from RCDOO or RCMOO. 


( I) 

Assume that this action Involves a stage 2 system startup* the 
CLM_USER file is assumed to include the following DEVICE 
direc tives * 

For cartridge disk-based systems* 

DEVICE RCDOO, I ,h,X'M0O' (removable cartridge disk) 

DEVICE FCDO0,3,6,X'14OO' (fixed cartridge disk) 

For cartridge module disk-based systems* 

DEVICE RCDOO,J,6,X'1400' (removable cartridge module disk) 
DEVICE FCM00,3,6,X'1400' (fixe cartridge module disk) 


I 


8-02 




i. Use the following CV (Create Volume) command to initialize the 
fixed olatter of the cartridge disk* 

CV !rCD(X) -FT ZUSR5 I 

(ZUSR5I is merely an axamole of a user-supplied volume.id). 

If your system is cartridge module disk-based* use the 
following CV (Create Volume) command to initialize the fixed 
platter of the cartridge module disk* 

CV !FCM(X) -FT ZUSR61 

(ZUSR6I is merely an example of a user-suoolied volume_Id). 

4. Use the following CP (copy) command to cooy the entire 
contents (except volume_ld) of ^ZSYSSI to *ZUSR5I * 

CP !RCD(X)>ZSYS5I IrCD(X) -VOL 

If your system is cartridge module disk-based, use the 
following copy (CP) ommand to copy the entire contents 
(except volume_id> of *ZSYS6I to *ZUSRdl *- -— 

CP !RCM00>ZSYS6I IFCMOO -VOL 

o. After the copy is completed, press STOP, 

6, Performs another stage 2 system startup, this time 
bootstraooing the system from FCD(X) or FCMOO, as aoprooriate, 
(Enter 1401 into the Rl-register after the TRAFFIC liaht turns 
off following .Stop, CLeaR, £,pad, jExecute), 

7, rthen system startup is complete, dismount ''ZSYS5I from RCDoo 
or *ZSYS61 from RCMOO. 

8, Mount a new cartridge disk on RCD'X) or RCMoo, as approoriate. 

9, For cartridge disk-based systems, use the following CV command 
to initialize the new cartridge disk* 

CV ! RCD(X) -FT USRVOL 

For cartridge module disk-based systems, use the following CV 
command to Initialize the new cartridge module disk, 

CV IRC.tffX) -FT USRVOL 

(USRVOL is merely an example of a user-supplied volume_id). 



10. Use the following CV command to create a bootstrap record on 
^USRVOL* (The bootstrap record must be on the removable 
volume, even through the system is to be bootstraooed from the 
fixed platter). 

CV !RCD(X)>USRVOL -BOOT IX'1401-Ml 

For cartridge module disk-based system, use the following 
command * 

CV JRCM00>USRV0L -BOOT CX'MOIM 1 

NOTH * After a bootstrap record on a removable cartridge disk 
or cartridge module disk has been used to bootstrap the 
system executive from the fixed cartridge disk or 
cartridge module disk, the volume_id of the fixed 
cartridge disk or cartridge module disk is assumed to be 
to the left of an absolute pathname that begins with a 
greater-than sign (>). 


SYSTEM SEARCH RULES AND THE SYSTEM COMMANDS 


The system builder should insure that system commands (or at least 
that subset of system commands most frequently used) are accessible 
to the system's loader. 

rfhen the system's loader seeks a bound unit to be loaded, it 
aroceeds as follows* 

If the user supolies a full pathname (one beginning with a 
circumflex and the volume id), then the system loader will search 
for that specific element. 

If the user supplies a simple (single-element) pathname, then the 
system loader will search for the element acording to a set of 
search rules. 

The search rules specify the order in which the loader is to search 
one or more directories for the element in the simple pathname. The 
default search rules for MOD 400 are (1) first search the user's 
working directory, £2) next search the system directory SYSLIBI on 
the root volume and (3) finally search the system directory SYSLXB2 
on tne root volume. 


( I) 

If X'1401' is not specified, 140) must be entered into the 
Rl-register (as shown in steo 6 ) whenever the system is 
bootstrapped from the fixed platter* however, other bootstrap 
options (see Table 3-2) can be used more flexibly If the bootstrap 
channel number (plus options) is entered into the Rl—register each 
time the system is bootstrapped. 


8-04 



The operator can use the CSD command to change the system search 
rules. In normal operations the operator should use the CSD command 
to specify that one of the directories to be searched is the system 
Jirectoryy containing the system commands. The user should note that 
those system command not accessible to the loader under the search 
rules must be specified with a full pathname. (For examole, the CP 
command would require the user to specify *volume_,id>SYSLIBl>CP)* 


PR()CEi3URS FOP TRANSFERRING SOFTWARE 


A procedure for transferring modules is described below. 

Prior to performing the orocedure, the user should, of course, 
determine the modules to be transferred and the unneeded elements on 
the volume to which new software is to be added. Section VII 
contains a description of the contents of all disks. 

1. Mount the volume containing the modules to be transferred on 
an available drive. 

2. Use a list names command (LS) to ascertain the size-cf the- 

modules to be transferred. 

3. Mount the volume to which the modules are to be transferred. 

4. Jse an L5 command to ascertain the size of unneeded elements. 

5. Release unneeded elements. 

6. Mount a new diskette on an available drive. Use a create 
volume command (CV) to initialize this diskette. (Use a 
temporary, unique volume identifier). 

7. Use a create directory command (CD to create appropriate 
directories on the new diskette. 

<3. Use a copy command (CP) to copy the remaining contents of the 
volume mentioned in step 3 to the new volume. 

9-. Ensure that the volume referenced in step I above is mounted 
and use a copy command to copy the approoriate modules to the 
new volume.(I) 

10. Use a CV command to rename the new volume* (If the new name 
duplicates the name of a currently-mounted volume, the system 
will issue a dismount message, directing you to dismount the 
newly-renamed volume). 

( I) 

When adding elements to the bootstrap volume, the system builder 
should remember that if a rollout capability is to be established, 
sufficient space must be available on the volume for the ROLLOUT 
file created during system configuration; this rollout file must be 
large enough to accommodate the batch memory pool. 
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APPENDIX A 


STARTUP HALTS 


Startup halts may be classified In three categories* 

. Halts related to bootstrap operation* 

* Error halts related to Configuration Load Manager. 

. Error halts related to other asoects of system Initialization. 

A halt related to the bootstrap operation may have heen 
Intentionally requested, or it may reflect an error condition. A 
bootstrap halt is intentionally requested by setting ON bit 13 of 
the 15-bit (four hexadecimal digits) bootstrap channel number (see 
Table 3—2). In the event of this type of bootstrap halt, the 
following register contents are significant* 

• Rl-register contains bootstrap channel number. 

. 22-register contains address mode flag* 0 Indicates SAP? 

I Indicates LAP. 

. 23-register identifies the bootstrap device type* 

3 indicates cartridge disk, cartridge module disk, or mass 
storage unit* I indicates diskette. 

Error halts during bootstrap result in a I6nn value in the 
Rl-register. See the System Messages manual for a description of 
the 1511, 1612, and 1615 error ha Its.” 

NOTE* If a bootstrap halt occurs with a 1516 error condition, there 
is a oossibility that the D7 register will contain no error 
status. To obtain status in such circumstances, select D7 
prior to retrying the operation and observe D7 during 
boots trap processing. 

Error halts related to the Configuration Load Manager result in a 
I3nn value in the R1-register, usually additional information 
relative to the halt is available in, or through, other registers. 
See the System Messages manual. Note that If an operator terminal Is 
connected to an MDC (and If its DEVICE directive has already been 
read), a Configuration Load Manager error condition oroduces an 
error message at the ooerator terminal* in this case, a halt occurs 
(in addition to the message) only under certain error conditions. 


A-01 




Configuration Load Manager error messages are described in the 
Syste.ii Messages manual. 

Error halts related to other asoects of system initialization result 
in a ?9nn value in the Rl-registeri in some cases additional 
information relative to the halt is available in, or through, other 
registers. See the System Messages manual. 



APPENDIX 8 
SYSTEM OVERLAYS 


Table B-t orovides a list of all system overlays that can be made 
permanently resident in the system area of memory. Each overlay to 
be made permanently resident must be named in a RESOLA directive 
(described in Section V). Multiple system overlays can be named in 
a single RESOLA directive* 

deside each overlay name in Table B-l is the approximate size (in 
decimal words) the overlay reouires in memory if it is made 
permanently reside.it. In certain cases* footnotes indicate otouds 
of overlays that should ali be made oermanently resident if optimum 
speed is desired for that function. 


Table B-t. System Overlays 


Overlay 

Marne 

Size 

(in Words) 

Function 




Executive 



Services 



OI >1 vis 

415 

OIM dispatcher (all LRN 0 orders) 

01MIMO 

321 

olM input processor 

OIOIMI 

401 

OIM command processor, output completion, and 



break handler 

0101 M2 

331 

OIM output control 

0101:43 

417 

OIM diagnostics 

0I0IM4 

451 

OIM abort group request purge and OIM monitor 



call handler 

0M3TAT 

277 

$STMP (status memory pool) macro handler, and 



get specific memory block 

OOdIMD 

226 

Loader - Processing of relocation items 









Table B-l <Cont). System Overlays 
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Table 3-f (Cont). System overlays 


Overlay 

Name 

Size 

(in words) 

Fune tlon 

OX Dr 3 T 

511 

Place deferred spawn task request 

Spawn deferred task (after defer Interval) 

OX3L3P 

448 

Delete/abort grouo (and abort group request) 

OXDTSK 

438 

Task Deletion (created or spawned tasks) 

Request task deletion (created tasks) 

OXSLOG 

471 

Error logging MCLs 

QXSSriO 

84 

External switch handler 

OXGACT 

323 

Group activate (rollout phase 2) 

OXJ35P 

274 

Group suspend (phase 1) 

OXJRQS 

3 12 

Start group request (phase 1) 

OXGR32 

422 

Group request startuo (ohase 2) 

OX'JRGT 

441 

Terminate group request (phase 1) 

OXJRT2 

243 

Terminate group request (phase 2) 

OXJRT3 

308 

Grouo request termination (phase 3) 

OX VO I 

337 

Message facility* MCL dispatcher 

OXMrOa 

480 

Message facility task request dispatcher* 

Call Mr MCLs 

OXMrJ3 

489 

Message facility activate mailbox? open 
mailbox file (accept and receive - disk 
queuing) 

OXMr04 

393 

Message facility* accept MCLs 

OX.Mr 05 

370 

Message facility* accept MCLs and read record 
from message facility file (acceot and 
receive - disk queuing) 

OX Mr 06 

398 

Message facility* initiate MCLs 

-OX.Mr 0-7- - 

- - 257 

Message facility* send MCLs 
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Table B-t (Cent). System Overlays 


Overlay 

Name 

Size 

(in words) 

Function 

biu-, ”, 



OX Mr 08 

383 

Message facility* send MCLs (disk 
queuing/backup)* terminate message MCLs 
(send) 

OXMr09 

377 

Message facility* receive MCLs 

OXMr10 

479 

Message facility* cancel enclosure level 

MCLs, delete ouarantine unit (receive MCLs - 
disk queuing/backup) 

OXMr 11 

427 

Message facility* terminate message MCLs 
(receive) 

OXMF12 

340 

Message facility* close mailbox (all 
terminate message MCLs * disks 
queuing/backuo* initiate MCLs - disk queuing; 
message count MCLs) terminate message MCLs 
(waiting acceptor) 

OXr>CBJ 

139 

Process command line* activate functions 

OXPCL1 

421 

Process command line* (Dhase J) 

OXPCL2 

. 434 

Process command line* (chase 2) 

OXPCL3 

3-55 

Process command line* break interrupt handler 

OXR3JP 

241 

Reouest and spawn group (phase f) 

OXR3J2 

328 

Request and soawn group (phase 2) 

OXRQG3 

26) 

Reouest and spawn 3 roup (when mailbox queued 
reouest) 

OXRST 

504 

Restart phase 1 

OXtfSTO 

428 

Restart phase 2 

OXRSTI 

483 

Restart phase 3 

OXRST2 

507 

Restart ohase 4 

OXRST3 

495 

Restart phase 5 

OXR5T3 

428 

Restart *= terminal substitution 

0XR3TF 

488 

Restart phase 6 (last) 

OXRSTH 

164 ! 

Restart ~ bound units preservation 
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Table 3-1 (Cont). System Overlays 


Overlay 

Name 

Size 

(in words) 

Function 

OXRSTP 

31 7 

Restart - trap processing and susDension 
activation during restart 

OXR5SR 

495 

Restart - error processing 

OXSIOI 

319 

Standard inout/output (new user* command^in) 

0X5102 

275 

Standard inout/outout (new user* user_out) 

0XSI03 

136 

Standard inout/output (input line expansion) 

0X5104 

119 

Standard inout/outout (system error_out 
handler) 

OXSMCL 

200 

Process semaphore MCLs 

OXTR 1 7 

204 

Defective memory trao handler 

OXTRPO 

315 

Connect user trao handler (enable, disable 
user traps) 

OXTRH 

139 

Terminal request handler 

OX JPrO 

265 

Idea tlfica tion/information macros 

QXUPF1 

138 

Identification/Information macros 

0XWC5I 

62 

Load Writable Control Store 

OX^TLO 

296 

Wait list processing 

rile Managment 


l)YA5r 

97 

Associate/disassociate file - MCL 

OYORr 

358 

Create file - '(CL 

OYC (H 

295 

Create record descriptors - MCL 

OYOLr 

506 

Delete file - MCL 

OYU<t= 

338 

Lin.< file - MCL 

OYMJr 

428 

Modify disk file attribute/name - MCL 

OY ULr* 

247 

Unlink file - MCL 
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Table B-l (Cont), System Overlays 


Overlay 

Name 

OZALX 

OZALX2 

OZCRF2 

(JZCRf'3 

(>ZCrfF4 

OZCRF5 

OZCRR2 

OZLKDR 

OZJLDR 

OYGI3V 

oYGIr 

OYGTr 

OYRMr 

OZGTF2 

OZGTr 3 

0ZCJ03 

OZCr'Jfl 

OZJrCB 

OZGTRr 

OYOrM 

OZOPFD 

OZOPrF 


Size 

(In words) Function 


292 Allocate disk space - record extent in 
directory 

459 Allocate disk space - GET space for one 
extent 

438 Create file - primary/alternate index 
parameter 

298 Create file - caic/ids-2 parameter 

259 Create file - permanent file 

427 Create file - temporary file and subroutines 

511 Build record descriptor 

248 Lin.< and rewrite directory record 

107 Unlink directory record 

83 Set device information - MCL 

506 Get file information - MCL 

403 Get file - MCL 

390 Remove file - MCL 

217 Get file -save/restore Interface 

442 Get file - taoe parameter processing 

313 Get file - create Device Descriptor Block 

(DDB) 

509 . Get file - create File Descriptor Block (FDB) 

504 Get file - get File Control Block (FC3) 

277 Get file - get related files 

443 Open file - MCL 1 

278 Open file - device files 

Ml Open file - fixed relative file 
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Table B-l (Cont). System Overlays 


Overlay 

Name 

Size 

(In words) 

Function . 




OZOPFU 

3'57 

Open file - sequenttal/relative/alternate 

Indexes 

OYCLS 

3SO 

Close file - MCL 1 

OZCLrD 

MO 

Close file - device files 

OZCRPT 

147 

Grouo termination 

OYACL 

471 

Set/delete Aceess Control (ACL) — MCL 

OZACL2 

486 

Set/delete Access Control (ACL) - set ACL 

OYAVR 

484 

Automatic Volume Recognizer (AVR) - MCL 

OYCMR 

437 

Cancel Mount Request (CMR) - MCL 

OYIT 

352 

Initialize Tape (IT) - MCL 

OY5WP 

348 

Swap volume - MCL 

OZAVR2 

507 

AVR - device file other than tape 

OZAVR3 

. 460 

AVR - initialize disk Volume Descriptor Block 
(VD8) 

OZVMT 

403 

Volume mount - request disk volume mount 

OZVMT2 

403 

Volume mount - request dev ice/tape volume 
mount 

OZVMT3 

406 

Volume mount - search for free tape 

OYCWD 

396 

Change working directory - MCL 

OYXPA 

437 

Expand file pathname - MCL 

OtSTTY 

447 

Set TTY - MCL 

OYWTrL 

241 

Wait file - MCL 

Storage Management 


OZSME 

131 

I/O error handler - common to all files 

- OZSME I-- 

131 

I/O error handler - disk files 

OZSMi*2 

222 

I/O error handler - message handler 
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Table B-l (Cont). System Overlays 


Overlay 

Name 

Size 

(in words) 

-» 

Function 

OZSMT 

111 

Storage management positioning function for 
tape 

OYBMCS 

506 

Buffer pool » create/delete (MCL) ^ 

()Y3Mul 

227 

Buffer pool - statistics (MCL) 

OYBMDL 

366 

Buffer poll - Delete adjust-' 

OZBM2 

287 

Buffer pool - flush buffers and disassociate 
buffers 

Data Management 


OYDMR2 

1 67 

Fixed relative - MCL 
(read/write/rewrite/delete record) 

OYDRM3 

203 

UFAS relative - MCL 
(read/write/rewrite/delete record) B 

OZDMS 

284 

UFAS relative - positioning 

OYDMSI 

255 

String - MCL (read/write/rewrite record) 

OZDM32 

‘ 511 

UFAS sequential - MCL (rewrite/deiete record) 

OZACCB 

173 

UFAS indexed/random - allocate CCB (Currency 
Control) 

OZUCC3 

448 

UFAS indexed/random - update CCB (Currency 
Control) c,d,e 

OZUSJB 

242 

UFAS indexed/random - common subroutines 3,c, ' i _^i 

0Y0MI1 

510 

Primary indexed - MCL (read/rewrite record) 3 

OYDM12 

299 

Primary indexed - MCL (write record in load 
mode) a 

OYUPI l 

476 

Primary Indexed - MCL (insert/delete record) 3 

(21 EXT 

512 

Primary indexed - initialize for extend mode 

(2MPF 

500 

Primary indexed - open and close 

OZIPSN 

502 

Primary indexed - positioning 

OYDMC 

. 364 

Calc - MCL (read/write/rewrite/deiete record) 6 
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Table B-I (Cont), System Overlays 
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Table B-1 (Cent). System Overlays 


Overlay 

Name 

Size 

(in words) 

Function 

QZTOP2 

512 

Tape - labeled tape 

OZTOP3 

316 

Tape - unlabeled tape 

0ZT0P4 

491 

Tape - process tape labels 

OZTPSN 

279 

Tape - positioning 

OZTSUB 

237 

Tape -subroutines, ASCII and binary 
conversion f 

OZTUTL 

380 

Tape - subroutines 

Checkooint, Restart, 

Record Lock, and Recovery Services 

OYOCPT 

293 

Checkpoint - MCL 

OZCKER 

427 

Checkpoint - error reporting 

OZCKPT 

479 

Checkpoint - internal check ooint 

OYRSRT 

438 

Restart - .MCL 

OYUREC 

, 293 

Unlock record - MCL 

OZBEF 

372 

Before image - data management interface 

OZBIJF 

255 

Before image - reservation 

OZBIIR 

417 

Before image - initialization 

OZBIOR 

296 

Before image - offline recovery 

OZBIWR 

275 

Before image - write before image h 

OZCLPT 

488 

Clean ooint - MCL h 

OZROLB 

413 

Roll back 

a 

TMs overlay should 

be made permanently resident if optimum speed 

is desired in processing UFAS indexed files. 

b 

This overlay should 

be made permanently resident if optimum speed 

| Is desired in processing UrAS relative files. 


w' 
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This overlay should be made permanently resident if optimum speed 
is desired in processing UJrAS random files. 

d 

This overlay should be made permanently resident if optimum soeed 
is desired in processing Indexed and random files* and alternate 
indices. 


This overlay should be made permanently resident if optimum speed 
is desired In processing files with alternate indices. 

f 

This overlay should be made permanently resident if optimum speed 
Is desired in processing llrAS tape files. 

g 

This overlay should be made permanently resident If optimum soeed 
is desired in processing EBCDIC tape functions. 

h 

This overlay should be made permanently resident if optimum speed 
is desired in processing using record lockIng/recorvery. 


This overlay should be made permanently resident if optimum speed 
is desired in processing file management functions. 

i 

This overlay,should be made permanently resident if optimum speed 
is desired in processing using buffer pool mangement. 





i 



APPENDIX C 

EQUIPMENT REQUIREMENTS 


This aooendix contains minimum system guidelines and a list of 
supported equipment. 


MINIMUM SYSTEM GUIDELINES 


Minimum system guidelines are offered as aids to system builders who 
must determine the resources required to oerform meaningful 
processing at the installation. Minimum system guidelines provide 
base configurations from which the system builder can calculate what 
additional memory and peripheral devices (if any) are necessary for 
efficient and effective operations. These guidelines will remain In 
effect until the next major release of MOD 400. 


Minimum System for Program Development 


Program development activity in a single-user environment can be 
accomolished with 64K words of memory (SAF or LAF) and a comoliment 
of peripheral devices limited to the following* one operator 
terminal, one printer, and up to four cartridge disks, cartridge 
nodule disks or mass storage units. 

In such an environment, the user can obtain an online memory oool of 
38K words (remaining memory would be reauired to accommodate the 
resident executive and a bK-word system memory pool). Additionally, 
this minimum system would allow the user to provide for the 
following exhaustible resources* two system overlay areas, 17 traps 
save areas, and 30 intermediate request blocks. 


Minimum System for Online Amplications (Execute-Only) SAF Mode 


A configuration with 48K words of memory (SAF mode) and a comoliment 
of peripheral devices limited to those described below will permit 
the execution of a wide variety of user applications In a 
singla-user environment.(t) 

( I ) 

The 2780/2730 Workstation Facility can be used in an environment as 
described above- with 32K words of memory. 


C-OI 



Two disks U) 


. One printer 

. One teleprinter-compatible terminal connected to an MLCP or 
OLCP 

. A PVE link 

In such an environment, the user can obtain an online memory pool of 
I3K words (remaining memory would be required for the resident 
executive and a 6K word system memory pool). Additionally, this 
minimum system would allow the user to provide for the following* 
the commercial simulator, two system overlay areas, 17 trap saw 
areas, and 30 intermediate request blocks. 


Minimum System for Offline Applications (Execute-Only) LAP Mode 


A configuration with 64K words of memory and a compliment of 
peripheral devices limited to those described below will permit the 
execution of a weide variety of user apolications in a single-user 
environment,(1) 

. Two disk (2) 

• vine printer 

. One VIP7200/05 or VIP7801/02 terminal connected to an MLCP or 
JLCP 

. A PVE link 

In such an environment, the user can obtain an online memory pool of 
IdiC words (remaining memory would be required for the resident 
executive and a 6K word system memory pool). Add!tionally, this 
minimum system would allow the user to provide for the intermediate 
request blocks and the Display Formatting and Control Facility 
software. 


(1) 

The 2780/2780 Workstation Facility can be used in an environment as 
described above with 32K words of memory. 

( 2 ) 

In an all-diskette system, it is recommended for ease-of-use that 
four diskettes be selected. 
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SUPPORTED HARDWARE 


Table C-l lists Level 6 eaulpment and options supported by MOD 400 
when operating on the Model 23 central processor. 

Table C-2 lists the Level 6 equipment and options supported by 
MOO 400 on other central processor models.(I) 


Table C-t. Supported Hardware - Model 23 


Category 

Marketing 

Identifier 

Description 

Central 

CPS9351 

23 Minimount, 32K, FCP, 5-slot, 

Processor 


no-disk 


CPS9352 

23 Minimount, 32K, FCP, 9-slot, 



no-disk 


CPS9353 

23 Minimount* 44K*.. FCP, S^slot,- 



no-disk 


CPS9354 

23 Minimount, 64fC, FCP, 9-slot, 



no-disk 


CPS9356 

23 Minimount, 32K, 8CP, 5-slot, 



no-disk 


CPS9357 

23 Minimount, 32K, BCP, 9-slot, 



no-disk 


CPS9358 

23 Mlnlmount, 641C, BCP, 5-slot, 



no-disk 


CPS9359 

23 Minimount, 64K, BCP, 9-slot, 



no-disk 


CPS9370 

23 Mlnlmount, 32K, FCP, 7-slot, 26MB 



cartridge module disk 


CPS937! 

23 Minimount, 64 K, FCP, 7-slot, 26MB 



cartridge module disk 


CPS9372 

23 Minimount, 64K, FCP, 7-slot, SOMB 



cartridge module disk 


CPS9373 

23 Minimount, 32K, BCP, 7-slot, 26MB 



cartridge module disk 


CPS9374 

23 Mlnlmount, 64K, BCP, 7-slot, 26ME 



cartridge module disk 


CPS9375 

23 Minimount, 64K, BCP, 7-siot, BOMB 



cartridge module disk 

Console 

KCM9301 

Single console adapter 

Adap ters 

KCM9302 

Dual console adapter 
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Table C-l (Cont), Supported Hardware - Model 23 


Category 

Marketing 
Identl fier 

Consoles 

DK U9 10! 
DKU9I02 

DKU9103 
DKU9104 

TWU9 104 
7WU9I06 
TWU9I08 
. TWU9!! 0 

Printer 

Adapter 

PRM930I 

Line 

Printers 

1 

I 

PRD9103 

PRU9104 
PRU9I05 

PRU9 106 
PRU9I08 
PRU9109 

Matrix 

Printers 

PRU9 112 

PRU9114 

Diskette 

Adapter 

DIM9301 


Diskettes DIU9I01 


DIU9I02 

DIU9I03 

DIU9104 


_ Description _ 

VIP 7100 console, 64—character set 
VIP 7100 console, 96-character set 
VIP 7200 console, 64-character set 
VIP 7205 console, 96-character set 
30CPS console typewriter 
I20CPS console typewriter 
30CPS console with numeric keypad 
120CPS console with numeric keypad 


M23 printer adapter 


240LPM printer* 96-character set 
300LPM printer* 64-character set 
440LPM printer* 96—character set 
600LPM printer* 64-character set 
660LPM printer* 96-character set 
900LPM printer* 64-character set 



Single-diskette (single-sided)* 
256KB 

Dual-diskette (single-sided); 

2x 256KB 

Single“diskette (double-sided)* 
512K3 

Dual-diskette (double-sided)* 
2x5!2KB 


Cartridge CDS9336 26MB cartridge module disk in cabinet 

Module Disks with 23 controller 

CDS9337 2x26MB cartridge module disk In cabinet 

with 23 controller 

CDS9338 BOMB cartridge module disk in cabinet 

with 23 controller 

CDS9339 2x80M3 cartridge module disk in cabinet 

with 23 controller 

CDU9136 26MB cartridge module disk in cabinet 

without controller 

CDU9137 2x26M3 cartridge module disk in cabinet 

without controller 

CDU913S BOMB cartridge module disk in cabinet 

without controller 

CDU9J39 2x80MB cartridge module disk in cabinet 

without controller 
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Table C-l (Cont). Suoported Hardware - Model 23 


Category 

Marketing 

Identifier 

Description 

Communication 

DCM9301 

M23 communication adapter* 2 asyn- 

Adapters 


chronous lines 


DCM9302 

M23 communication adapter* 1 syn- 



chronous lines 


DCM9303 

M23 communication adapter* 2 syn- 



chronous lines 


DCM9304 

M23 communication adapter* 1 syn- 



chronous and 1 asynchronous line 

Terminals 

Asynchronous 



Terminals 



VIP7100 

CRT terminal, 64-character set 


VIP7I05 

CRT terminal, 96-character set 


VIP7200 

CRT terminal, 64-character set 


VIP7205 

CRT terminal, 96-character set 


VIP7301 

CRT terminal, 12-lnch screen 


VIP7302 

CRT terminal, 15-inch screen 


VAF7321 

Buffered orinter adapter for all 



VIP 7800 terminals 


W U1001 

Keyboard/orinter, 30 cps 


Trt U1003 

Keyboard/printer, 30 cps 


■mu 1005 

Keyboard/orinter, 120 cps 

* 

PRU1001 

Printer terminal, 30 cps 


PRUI003 

Printer terminal, 30 cps 


PRU1005 

Printer terminal,, 120 cps 


Synchronous 



Termi nals 

- 


VIP7700 

CRT terminal, 62-character set 


VIP7705 

CRT terminal, 95-character set 


VIP7700R 

CRT terminal, 63-character set 


VIP7705R 

CRT terminal, 95-character set 


VIP77*0 

CRT terminal, 95—character set 


Subsystem 



VIP7804 CRT terminal, 12-inch screen 

VTP7805 CRT terminal, 15-inch screen 

VAF7821 Buffered orinter adapter for all 

VIP 7800 terminals 


ROP Printers ROP printers are generally supported 

















Table C-l (Cont). Suoported Hardware - Model 23 



Writable Control Store (CPF9509) is offered for 
system builder use only. Although Writable Control 
Store is usable under GOOS 6 MOD 400, full end-user 
software support is not available. 


System 

Building 

Products 







Table C-2. Hardware Supported - Model 3X« 4X and 5X 


Ca tego ry 

Marketing 

Identifier 

Description 

i Central 

CPS9470 

Model 33 Central Processors! 

i Processors 

CPS947I 

memory to 64K words 


CPS9472 



CPS9473 



CPS9560 

Model 43 Central Processors! 


CP5956 1 
CPS9562 

memory to 1024K words 


CPS9563 



CPS9566 

Model 47 Central Processors! 


; CPS9567 

Commercial Model! memory to 

J024K words 


CPS9570 

Model 53 Central Processors! 
includes VMU and Cache! memory 
to 1Q24K words 


CPS9572 

Model 57 Central Processors! 

Commercial Model weith MMU and 
Cache! memory to t024(C words 

Multiple 

MDC9lOt 

Multiple device controller 

De viee 
Controller 



Console 

KCM9I0I 

Keyboard console device-pacs 

Device-pac 



1 

Consoles 

DKU910 I 

VIP 7100 console 


DKU9I02 

VIP 7105 console 


DfC U9 J 03 

VIP 7200 console 


DKU9104 

VIP 7105 console 


TW U9 104 

300CPS console typewriter 


TWU9I06 

(20CPS console typewriter 


TWU9108 

30CPS console with numeric keypad 


T/tU9 t 1 0 

120CPS console with numeric keypad 

Printer 

PRM9I0I 

Printer device-pac 

Device-pac 



Line Printers 

PRU9I03 

240LPM, 96-character set 


PRU9104 

300LPW, 64-character set 


PRU9I05 

440LPM, 96—character set 


PR U9 106 

600LPM, 64-character set 


PRU9I03 

660LPM* 96-character set 


PRU9I09 

900LPM, 64-character set 

Ma tr i x 

PRU91 12 

. 120CPS matrix orinter 

Printers 

PRU9 114 

I60CPS matrix printer 
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Table C-2 (Cont). Hardware Supported - Model 3X, 4X and 5X 


Category 

Marketing 

Identifier 

Descriotion 

Card Reader 

CRM9101 

Card reader device—pac 

Device-pae 


1 

Card Readers 

CR U9108 

r _ 

300CPM 


CR U9109 

300CPM, IBM mark sense 


CR U9 110 

300CPM, HIS mark sense 


CRU9 1 ! 1 

500CPM 


CR U9 J1 2 

500CPM, IBM mark sense 


CRU9113 

500CPM, HIS mark sense 

| Card Punch and 

CRM9103 

Device-Pac for card punch and card 

Card Reader/ 


reader/punch 

Punch Device" 
Pae (Adapter) 



Card Punch 

PCU9I01 

Card punch, 100 cpm 

Card Reader/ 

CCU9I01 

Card reader/punch, 400/100 cpm 

Punch 


Diskette 

DIM9101 

Diskette device-oac for 2 single- 

Device-pacs 


sided diskettes 


DIM9102 

Diskette dev ice—pa c for (2) 1- or 
2-slded diskettes 

Diskettes 

DIU9I01 

Single diskette (single-sided) f 

256KB 


DIU9102 

Dual diskette (single sided), 

2x256K3 


DIU9103 

Single diskette (double-sided), 

512KB 


DIU9104 

Dual diskette (double-sided), 

2x512KB 

Cartridge 

CDU9J16 

10MB (5+5) cartridge disk with 

Disks 


controller 


CDS9116 

10MB (5+5) additional disk without 
controller 

Cartridge 

CDS9I36 

26MB CJ3F + 13R) in cabinet with 

Jfodule Disks 


controller 


CDS9137 

26MB in cabinet with controller 


CDS9138 

BOMB (6 7F + I3R) in cabinet with 
controller 

1 

CDS9139 

Dual 80M8 in cabinet with 


1 

controller 

i 

CDU9136 

26MS in cabinet without controller 


CDU9I37 

Dual 26MB in cabinet without 

- 


controller 
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Table C-2 (Cont). Hardware Supported - Model 3X, 4X and 5X 



Marketing 


Category 

Identifier 

Description 



CDU9I38 

90MB In cabinet without controller 


CDU9I39 

Dual 30MB in eablnet without 
controller 


CDS9123 

26MB ( I3F +• J3R) with controller 


CDS9I25 

30MB (67F *■ J3R) with controller 


CDU9123 

26MB add-on unit without 
controller 


CDU9125 

30MB add-on unit without 
controller 


Mass Storage 
Units 

MSS9I02 

MSS9I04 

MSS9I07 

MSU9I02 

MSU9104 

MSU9107 

Mass storage unit in cabinet with 
controller 

256MB mass storage unit in cabinet 
with controller 

Dual 67MB mass storage unit In 
cabinet with controller 

67MB mass storage add-on unit 
without controller 

256MB mass storage add-on unit 
without controller 

Dual 67M8 mass storage add-on unit 
without controller 

Magnetic Tape 
Controllers 

MTC9I0I 

Magnetic tape controller, NR2I 
drives 


‘MTC9102 

Magnetic tape controller, PE/NRZI 
drives 

Magnetic Tape 
Devlce-Pacs 

MTM9I0I 

Magnetic tape Device-oac, 7-track 
dr i ve s 


MTM9I02 

Magnetic taoe Device-oac, 9-track 
drives 


Magnetic Tape 
Drives 

i MTU9I04 

Magnetic tape drive, 9-track NRZI, 

45 inches per second (ios) 


MTU9 105 

Magnetic taoe drive, 9-track NRZI, 

75 1ps | 


MTU9I09 

Magnetic tape drive, 9-track NRZI/ i 

PE, 45 ips 


MTU9110 

Magnetic tape drive, 9-track NRZI/ 

PE, 75 ios 

• 

MTU911 2 

Magnetic tape drive, 7-track NRZI, | 

45 Ids i 


MTU91 1 3 

Magnetic taoe drive, 7-track NRZI, 

75 ip s 


MTU9 114 

Magnetic taoe drive, 9-track PE, 

45 1 ps 


MTU9 J15 

Magnetic tape drive, 9-track PE, 1 

75 Ips 
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Table C-2 (ContK Hardware Supported - Model 3X, 4X and 5X 


Category 

Marketing 
Identifier 

Description 

Communication 

MLC9103 

Multiline communications processor 

Controllers 

MLC910I 

MLCP with 8 asynchronous lines* 
includes 4 communlcation-pacs 


MLC9102 

MLCP with 8 synchronous lines* 
includes 4 communication-pacs 


MLC9I04 

MLCP with 3 current loop lines* 
includes 4 communication-pacs 

Communications- 

DCM9101 

Communications-pae , two asynchro- 

Pacs 


nous lines, cable 


DCM9I02 

Communications-pac, one asynchro¬ 
nous lines, cable 


DCM9103 

Communications-pac , two synchro¬ 
nous lines, cable 


DCM9I04 

Communlcations-pac , one synchro¬ 
nous lines, cable 


DCM9i05 

Communications-pae, one current 
loop line (Sell 301/303 modem 



comoatible) 


DCM9106 

Communications-pac, one medium 
speed, synchronous, HDLC line 


DCM9108 

Communications-pac » broadband line 
(CCITT/V35 compatible) 


DCM9I09 

i 

Communicatlons-oac f two synchro¬ 
nous lines (MIL J88C compatible) 


DCM9 1! 0 

Communications-pac, Autocall Unit 



for one or two synchronous or 
asynchronous lines 


DCM9I ! t 

Communlcations-oac , one asynchro¬ 
nous current loop line 


0CM9 I i 2 

Comraunlcations—pac, broadband HDLC 
line (Bell 301/303 modem comoat¬ 
ible to 72KB) 


DCM9 ) 13 

Communications-oac , broadband HDCL 
line (CCITT/V35 compatible to 

72 KB) 


DCM9 114 

Communicatlons-pac, two asynchro¬ 
nous current loop lines 


DCM9 ] 1 5 

Communications-oac , broadband syn¬ 
chronous line (MIL 183C compat¬ 
ible to 5hKB) 


DCM9 1l6 | 

Communlcations-pac * two asynchro¬ 


1 

nous lines (MIL 188C comoatible) 


DCM9120 

Communications-pac, HDLC to 19 2K3 



MIL 18 SC 


DCM912I 

Communications-Dac broadband HDLC 

MIL 188C 


DCM9I26 

Communications-pac INCOTERM 
connection 
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Table C-2 (Cont). Hardware Supported - Model 3X, 4X and 5X 


Category 

Marketing 
Identlfier 

Description 

Terminals 

Asynchronous 

Terminals 



VIP7I00 
VIP7105 
VIP7200 
VIP7205 
VIP7300 
VrP7802 
VAF7821 

TWUIOOI 

7WUI003 

TXUI005 

PRU100J 

PRUI003 

PRU1005 

CRT terminal, 64-character set 

CRT terminal, 96-character set 

CRT terminal, 64-character set 

CRT terminal, 96-character set 

CRT terminal, 12-inch screen 

CRT terminal, 15-tnch screen 

Suffered orinter adapter for all 

VIP 7800 terminals 

Keyboard/printer, 30 cos 

Keyboard/printer, 30 cps 
Keyboard/orinter, 120 cos 

Printer terminal, 30 cps 

Printer terminal, 30 cps 

Printer terminal, 120 cps 


Synchronous 

Terminals 



VIP7700 
VIP7705 
VIP7700R 
VIP7705R 

CRT terminal, 62-character set 

CRT terminal, 95-character set 

CRT terminal, 63-character set 

CRT terminal, 95-character set 


VIP7760 

Subsystem 

CRT terminal, 95-char3Cter set 


VIP 780 4 
VIP7805 
VAF782I 

CRT terminal, 12-inch screen 

CRT terminal, 15-lnch screen 

Buffered orinter adaDter for all 

VIP 7800 terminals 


ROP Printers 

ROP printers are generally 
suooorted 
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Table C-2 (Cont). Hardware Supported - Model 3X, 4X and 5X 


Ca tegory 


Modems 


System 
Buiidlng 
Products 


Descriotlon 


Modem suooorted for asynchronous communications 
terminals are* 

. 103* 113, 202 tyoe modems. (These modems must be 
equiped with the option to disconnect the data 
set after a carrier drop of HO milliseconds). 

. CII HONE WELL BULL modem bypass. 

. Modem tyoes where the connection, disconnection, 
and data set control settings can be 
user-specified. 

Modems supported for synchronous communications 
terminals are * 

. 201, 20IA, 2GIC, 208, and 208B tyoe modems. 

.CII HONEYWELL BULL modem bypass. 

• Modem tyoes where the connection, disconnection, 
and data set control settings can be 
user—specifled, 

. Broadband modem. 

A modem is not required for a direct-connect 
asynchronous term!nal, or a synchronous terminal 
with a timing source in the terminal or in the 
MLCP. 

Writable Control Store (CPF9509) is offered for 
system builder use only. Although Writable Control 
is usable under GC()S 6 MOO 400, full end-user 
software support is not available. 
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APPENDIX D 
POWER RESUMPTION 


NOTE* The Power Resumption facility is not supported on systems with 
an MLCP-connected operator's console. 

The power resumption facility allows the system execution 
environment to be restarted after a power interruotion. The central 
processor must have the memory save and autorestart unit* This unit 
can preserve the memory imaje through a power failure lasting up to 
two hours. It cannot, however, preserve the state of the I/O 
controllers, ensure that no operational changes have been made to 
the mounted volumes, nor preserve the contents of the multiline 
communication processors. Restoration of this system information is 
accomplished through the power resumotion facility. 

if fewer than two hours have elasped when power is returned to the 
central processor, the power resumotion facility performs the 
following actions* 

. Reinitializes the I/O controllers 

. Reconnects terminal devices (TTY and ATD devices) 

. Reestablishes the integrity of mounted volumes 

. Restarts the communications subsystem (TTY and ^TD devices 
only) 

* Restarts the application tasks that were active at the time of 
the failure 

. Signals a cower resumption software trap to tasks that have a 
handler enabled for this trao 

. Restart Display Formatting and Control processing 

If the power remains off for more than two hours, the memory image 
is destroyed and the power resumption facility is disabled. The 
"memory on" Indicator contained In the memory save and autorestart 
unit-is lit* The operator must manually reset this indicator before 
rebootstraoping the system to oerform a restart. See the Mini 6 
Minicomputer Systems Handbook for detailed information about the 
uaamory save and autorestart unit. See the Operator's Guide for 
procedures used in restarting after a system failure. 
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POWER RESUMPTION CONFIGURATION REQUIREMENTS 


To implement the power resumption capability, you must configure the 
following * 

. Memory save and autorestart unit 
. Power resumption facility 
. Automatic terminal reconnect 

Note that peripheral devices (those devices not attached to an MLCP) 
are designated automatically reconneetable when they are configured 
at system building# These devices are reconnected when power is 
restored. 


Configuring Memory Save and Autorestart Unit 


Pour small recker switches, located behind the full control panel on 
the control panel circuit board, supply configuration information to 
the central processor. The switch on the extreme left (when the 
panel is ooen) is the volatile memory switch. It must be set off 
(pushed down) to inform the system that the memory save and 
autorestart unit is present. 

NOTE* On some control panels, the volatile memory switch is on the 
extreme right. See the Mini 6 Minicomputer Systems Handbook 
for complete details. 


Configuring Power Resumption Facility 


You add the power resumption facility to your system by including 
the following LDBU directive in the Configuration Load Manager (CLM) 
file. 


LDBU ZXPFR 

See Section V for a description of the LDBU directive. 


Configuration Automatic Terminal Reconnect 


Each communication device (each terminal connected to an MLCP) that 
is to be automatically reconnected by the power resumption facility 
must be so designated using the STTY command with the -RECONNECT 
argument in your CLM file. See the description of the STTY command 
below. 
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STTY 


STTY COMMAND 


Command Name* 5TTY 

Change or display the file characteristics of a communications 
terminal. Can be used as an alternative to the STTY directive 
format in the Configuration Load Manager (CLM) file. Provides 
features not supported by the STTY directive. You must include an 
STTY command in your CLM file for each terminal that you wish to 
configure as being reconnectable in the event of a system power 
failure. 


Forma t * 

STTY [device^name) ctl_arg 


Argument Description* 
device„name 

The I- to 6-character device name of the terminal* use of the 
exclamation point character as a prefix is optional (e.g., TTY01 or 
!TTYOI can be used). 

Default* The terminal from which this command is issued, 
c tl_a rg 

One or more of the following control arguments must be soecified. in 
any order. If an argument is unsoecifled the corresponding current 
value for the terminal remains in effect. 

„LL n 

Decimal Integer specifying the desired line length. This value 
excludes the control byte. 


-TYPE < 0 

i B 

Set the device type to inout-oniy (I). output-only f0). or 
bidirectional (3). 

-TABS IM ( YES ) 


Insert space characters, where needed, to simulate tabbing. If 
the terminal does not suoport tabbing and the output data has tab 
characters, specify YES. 
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Prepare the device to receive asynchronous buffered (A), 
synchronous buffered (S), or nonbuffered synchronous (N) input. 
(See the "Function Description" for a description of 
asynchronous * synchronous, and buffered). 



Prepare the device to transmit asynchronous buffered (A), 
synchronous buffered (S), or nonbuffered synchronous (N) output. 
(See the "Function Description" for a description of 
asynchronous, synchronous, and buffered). 

reconnect! YES) 


Specifies whether or not this terminal should be automatically 
reconnected following a power failure or line drop condition. If 
YES is specified, the terminal will be automatically 
reconnection. If NO is specified, no automatic reconnection will 
taice place t The default is NO. 

PRINT 

Display the current characteristics (name, device-type, line 
length, etc.) for the terminal. 

MODES mode ... 

Set the terminal to operate in the specified models). To reset a 
mode, precede the mode with a circumflex C"). For example, -MODES 
ECHO, ~HANG_UP sets the terminal to echo keyboard input and to 
"not" hang up the phone when the file is closed. Any number of 
modes can be set or reset in any combination. In any order. If a 
particular mode is not specified, that mode is not changed. 
Possible modes are listed below. To set a mode, you must know 
which line protocol handler (LPH) is servicing the terminal. The 
-PRINT argument can be used to display the current mode settings 
to determine which modes can be set or reset. 
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Mode 

Meaning 

LPH 

ECHO 

Echo keyboard Input. 

TTY, A ID ( 1) 

AUTOCALL ( 

AC* / 

Use the Auto-Cail unit when the 
file is opened. 

ALL 

TRANSPARENT \ 

TR i 

Input data Is In transparent 
mode. 

TTY, AID, BSC 

STQP.OUTPUT l 

SO / 

If an outout order Is In prog¬ 
ress* stop It Immediately if a 

BRK is Issued from the terminal. 

TTY,AID 

LINEFEED l 

LF / 

Line feed at end of message. 

TTY,ATD,VIP, 

STD 

CARRIAGE.RETURN 

CR 

1 Carriage return at end of 

f message. 

TTY .ATI),VIP 
STD 

CONTROL.BYTE \ 
cs f 

(Xitput sent to the terminal 
starts with a control byte. 

TTY,AID,VIP 
STD, BSC 

BUC.XFER I 

BL K f 

Data transfer is in buffered 
(blocx) mode, not character 
mode» 

TTY,ATD 

HANG.UP 1 

HU f 

Hang uo the phone when the file 
is closed. 

ALL 

HOME 

Set cursor to home on page 
overflow. 

VIP,STD 

FCTN 

Suoport VIP function codes. 

VIP.STD,PV5 

DEL 

Include received DEL characters. 

PVE 

The following special keywords can be used with 
the VIP line protocol handler to set various 
time-out and polling Intervals* 

To 

Time-out immediately (after 1 
poll). 

VIP,STD 

TOIO 

Time-out after 10 minutes of 
polling. 

VIP,STD 

~TO 

Mo time-out (i.e., indefinite). 

VIP,STD 

~PI 

No polling interval (i.e., 
continuous). 

VIP,STD 

PI t 

l-second poll interval. 

VIP,STD 
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Mode 

Meaning 

LPH 

PI2 

2-second poll interval. 

VIP,STD 

PI 3 

3-second poll Interval. 

VIP,STD 

PI4 

4-second poll interval. 

VIP,STD 

PI5 

5-second poll Interval. 

VIP,STD • 

PI 15 

15-second poll interval. 

VIP,STD 

PI30 

30-second poll interval. 

VIP,STD 

-RESET 




Reset the inodes to those designated at system building. 

OSWI h 

Set the terminal's device-specific word to be used at open 
(connect) and close (disconnect) time; this argument is an 
alternative to using the -MOOES argument, h is a 4-character 
hexadecimal value. This argument requires detailed knowledge of 
terminal I/O and should be used only if you understand line 
protocol handlers and have read the Communications Processing 
manual. 

—DSN2 h 

Set the terminal's device_soeeific word to be used when the file 
is read or written; this argument is an alternative to using the 
-MOOES argument, h is a 4-character hexadecimal value. This 
argument requires detailed knowledge of terminal I/O and should 
be used only if you understand line protocol handlers and have 
read the Communications Processing manual. 

NOTES* 

1. Only the current device-specific word assignments can be 
modified; i.e., not the initial device-specified words 
established through the STTY directive during system 
building. 

2. No consistency checks are made; if the -DSNI or -DSH2 
argument specifies logically inconsistent or imoossihle 
conditions, relative to the actual device type, no 
notification of error is given and the indicators are set 
as requested. 
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FUNCTION DESCRIPTION* 


The set^terminal characteristics (STTY) command permits you to 
modify or'display the file characteristics associated with a 
terminal or endpoint that is not currently reserved. The original 
terminal characteristics t established during system building, can be 
altered to reflect your current needs. To use the -IN and -OUT 
arguments, you must understand the meanings of the terms buffered, 
asynchronous, and synchronous* These terms are described below. 

Buffered means that an intermediate data storage area is used before 
data is transferred to/from a device. For input, data is received in 
system memory and then moved to used memory. For output, data is 
moved from used memory to system memory a t -d then to the device. 
Nonbuffered means that data is transferred directly from user memory 
to the device. 

Asnchronous data transfer is the concurrent transfer of data and 
execution of an aoplic3tion program* I.e., processing can continue 
during a read/write operation. Asynchronous operations are always 
buffered. 

In synchronous data transfers, processing waits for completion of a 
read/write request. Control returns to the requestor after the 
transfer is complete. Synchronous operations may be buffered or 
nonbuffered. 

The ooerating characteristics of the application program determine 
whether asynchronous buffered (A), synchronous buffered (S), or 
synchronous nonbuffered (N) are specified In the -IN and -OUT 
arguments. Generally, If an application program is directed towards 
multiple terminals, specify A so there Is full user interaction. If 
S or N Is specified and someone Issues a read or write, all other 
users have to wait. This Is explained in more detail below. 

rfith asynchronous input, if an application program issues a read 
request, the system waits for previous read operations to complete. 
The data is moved to the application program, the read reauest just 
issued is placed in a queue, and control immediately returns to the 
application program. If the aoolication program is interacting with 
only one terminal, asynchronous Input is efficient, but not 
necessary* the application orogram can process a message while the 
file system reads the next message. Asynchronous Input is necessarv 
for an application program to interact with multiple terminals. For 
multiterminal aoplications, an application program may poll 
terminals and wait for input from a list of terminals. 

Asynchronous output permits "double buffering" output requests. Ahen 
an aoolication program issuas a write request, the system waits for 
previous write requests to complete. Data is moved from the 
application program to a system buffer, the write reouest is placed 
In a queue, and control Immediately returns to the application 
program. 

MOTE* For single-terminal applications using the roll-out feature, A 
or S provides more efficient ooeration. 



exampie * 


STTY ! VIPOl .MODES '’‘CONTROL.BYTE ,~STOP„OUTPUT, 
AUTO_CALL,~HANG.UP 

or 

STTY VIPOl -MODES ^CB,^SO,AC,~HU 

rile Input/output to VIPOl will not expect a control byte before 
each output message. Finish printing output message that may be in 
progress when a BREAK is detected. Use the Auto-Call unit when file 
is opened. Do not hang up the phone when the file is closed* 


ACTIONS FOLLOWING POWER RESUMPTION 


When the power resumption facility restarts the execution 
environment* it automatically performs a number of system functions, 
rthen the operator and system users are notified that power 
resumption has occurred, they may be required to perform certain 
actions. 


Automatic Functions 


The power resumption facility automatically performs the following 
functions * 

o Restarts the device drivers, clock, and communications 
subsystem. 

o Reconnects peripheral devices. Reconnects terminal devices that 
were designated as being automatically reconnectable. 

. Resets the system date and time, (The date/time clock has a 
separate battery backuo unit* it is supported through the 
real-time adapter), 

, Reloads the memory management unit. 

• Restarts all tasks that were active when the power failure 
occurred. 

In addition to these automatic functions, the system operator and 
system users may be required to perform certain actions. These cower 
resumption procedures are described In the Operator's Guide. 
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APPENDIX E 

DATA ENTRY FACILITY - I 


This Aopendix describes a typical configuration procedure that can 
be used to accommodate DEF-I, and list the Linker directives that 
are required to link a DEF-I system. 


CONFIGURATION 


GC03 6 MOD 400 software requires that the following steps be 
performed before the Data Entry Facillty-I can be used* 

1. During system building, ensure that the directives required by 
the DEF—I system are included in the CLM_USER file. 

2. Generate a DEF-I system Linker directive file that suDOorts 
the user's CLM_USER file. 

NOTE* To aid in steps ! and 2, a sample DEF-specific Linker 

directive file (DEF_SAMPL£.S) is suoolied on the media. 
It may be modified to meet the requirements of the 
particular Installation. 

3. Execute a Linker run to produce a DEF-I bound unit. 

4. Optionally, execute a Linker run to produce a user suoolied 
date entry program. 

5. Generate the appropriate DEF—I system user group and Start-Up 
task command files. 

To aid in an understanding of this process, a samole DEF-I system 
configuration is used throughout this aopendix. 

Configuration parameters include* 

. 4 operator display stations 
. 1 line printer 

. I data entry orogram overlay area 
. 2 DEF-I background tasks 
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CLM—USER FILE 


After the OCOS 6 MOD 400 system has been initially loaded by a stage 
t system startup, you must define a file of configuration 
directives, called the CLM.USER file, for the Configuration Load 
Manager (CLM); This file will contain the Symbolic Peripheral Device 
names (SPD), communications arguments, and memory pool assignments 
necessary to use GCOS 6 MOD 400 software on a Mini 6 system. 

The CLM„USER file directives need not be completely DEF-specific. 
That Is, the devices, memory, etc., described in the CLM.USER file 
may be shared by other system function facilities and may Include 
specifications not required for the Data Entry Facility-I* 


Sample CLM_USER File 


Figure E-I illustrates a CLM_USER file for a Data Entry Facility. 

The file specifies a system with four operator display stations, one 
attached through an MDC (CONOU and three attached through an 
MLCP/DLCP (TTX). Additionally, there are two diskettes and a line 
printer. (The bootstrap device is left implicit here). 

DEVICE fCSR00,Q,5,X'0500',CONSOLE, 140 

COMM 7 

TTX !2,8,X'rr00',Q,9400 
TTX l3,9,X'Fr3CK,0,9600 

DEVICE CONOI ,'J4,10,X'0580' ,C0N0l ,80,N,'7200' ,T 
TTX !5, 11,X<VE80' f 0,9^00 
PVE )<5,1 A,X'rC00',2,O0 
PVE 17,16,X'FC00',2,01 
DEVICE DSK00,5,I4,X'0480' 

DEVICE DSKOl,6,I5,X'0480' 

DEVICE LPTOO,8,) 7,X'1380^,LPT00 
MEMPOOL S,,^000 
MEMPOOL ,AB,* 

SYS ,,,5,20,80,,E 
QUIT 

Figure E-l. Sample CLM_USER File 
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CLM.iJiER File Directives 


The following CLM_USEf? file direct!ves are used for a system that 
includes Ddr-I. 


DEVICE DIRECTIVE 


A DEVICE directive is required for each device—except a 
communications (MLCP/DLCP-connected) operator display station—used 
with JEr-I. (A DEVICE directive may be paired with a TTX directive 
used for a communications operator display station If the device is 
to be accessible through the file system interface). The DEVICE 
directive is described in Sections V and VI* in addition, note the 
following points* 

. A noncommunications (MDC—connected) operator display station 
requires the device arguments specifying non-buffered teletype 
mode of the DEF-I workstation he used (see Section V). 

. If a DEVICE directive is oaired with a TTX directive (described 
below), the DEVICE directive's device_unit argument value must 
be TTYnn (See Section VI to ascertain the device 
characteristics achieved by TTYnn), For example* 

DEVICE TTYCOJS, (I ,XVc8O' I TTY00,30 

Table E-l list the devices configured in Figure E-l and their 
associated device_unit argument values. 


Table E-l. Devices Configured In Figure E-l 


Device Type 

Number 

Configured 

Device„Unlt 
Argument Values 

Console 

1 

KSROQ 

Operator Display 
Station—MDC- 
connected TTY 

1 

CONOt 

Diskette 

2 

DSKOO,DSKO1 

Line Printer 

1 

LPTOO 


rfhen more than one operator display station is configured for DEF-I, 
those CRT's must be assigned consecutive logical resource number 
(LRN's). Similarly, all system line printers used by DEF-I must be 
assigned consecutive LRN's. 



In Figure £-1, the four operator disolay stations use the sequential 
LRN's 12* 13, 14, and 15. 

Also note that the number of devices configured in the CLM„U$ER file 
may be greater than those specified when linking the DEF-I system 
(see below). Thus the DEF-I bound unit may be linked for three CRT's 
even if the CLM_USER file specifies four. 


COMMUNICATIONS SYYSTEM DIRECTIVE 


The Comm directive specifies that a communications subsystem Is 
used. In Figure E-l, the communications subsystem is given a 
hardware interrupt level of 7. High orlority hardware levels should 
be used for communications interrupts to ensure satisfactory 
operation. 


rrx DIRECTIVE 


The TTX directive specifies a TTY-type communications device* 
However, unlike the TTY directive, it provides an 80-character 
buffer. This buffer, and therefore the TTX directive, is reaulred 
for all DEF-I operator display stations attached through an 
MLCP/JLCP. 

The TTX directive appears as follows* 

rrx Irn,level,X'channel',[modem)!,speedl 

Refer to the TTY directive in Section VI for a description of the 
TTX arguments. 

In Figure E-i, there are three MLCP/DLCP connected operator display 
stations, and therefore three TTX directives. 


MEMORY POOL DIRECTIVES 


A MEMPOOL directive is used to specify the system memory pool size. 
Additionally, an online user memory pool—^either exclusive or 
.lonexclusive—must be spedfied for the DEF-I system. The minimum 
required size deoends upon which DEF-I system functions are linked 
as resident and which are overlays, and upon the number of DEr-I 
workstation buffers required. Memory requirements are further 
described under "Linking a DEF-I System” below. The MEMPooL 
directive is described in Section V. 
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In Figure E-l , the DEF-I system is configured with a single 
nonexclusive online memory pool with the name A3* this oool extends 
from the end of the system memory dooI to high memory. This single 
oool can be used by the DEF-I system and by any other function in a 
group assigned to this pool, e.g. , the COBOL comoiler. 


SYSTEM DEFINITION DIRECTIVE 


The SYS (system definition) directive is described in Section V. The 
following consideration aooiies to DEr-I. 

It is advisable to create several system overlay areas to Improve 
the likelihood that a needed overlay is already present in memory 
(because it was recently used) and does not have to be reloaded. 

This is done through the "Qian" argument of the SYS directive* 5 is 
a recommended value. 

It is also recommended that the user allocate additional interrupt 
request blocks for each DEr-I workstation. In Figure E-l, 30 
interrupt request blocks have been aided for four workstations. This 
configuration suooorts activities in a hlgh-throughout data entry 
environment. In a more casual data entry environment, approximate ly 
10 additional interrupt request blocks oer workstation would he 
adequate. 


LINKING A DEr-I SYSTEM 

The following paragraphs describe the requirements for linking* 

. A DEr-I system bound unit 
. A DEr-I data entry programs bound unit 

The Linker directives are discussed in the Program Executive snd 
Checkout manual, 


DEr—I System Directories 


The DEF-I system object units are located in the directories listed 
in Table E-2, depending upon the system software medlu<». 


E—05 




Table £~2. DEF-I Object Unit Directory Pathname 


Medium 

Directory Pathname 

Diskette 

Cartridge Disk 

Mass Storage Unit 
Cartridge Module Disk 

~ZSYSIO>ZDRT 

~ZSYS5I>ZDRT 

^ZSYS7J>ZDRT 
^ZSYS61>ZDRT 


QEF System Object Units 


The Dcr system object units are grouped in Table E-3 according to 
function. Some of these units are linked internally, and do not 
need to be specified when linking DEr-I* 


Table E-3. DEF-I Object Units 



object 

Units 

Function 

Specified 

Not Specified 

System object Units 

DEF—I Control 

ZD.-LTD, 

ZDFCRT, ZDrINI, ZDFSTB, 


ZDrCTL 

ZDrDDH, ZDFBM t ZDFPH, 


ZDFIAD 

ZDrPRW, ZDrOLY, ZDr MSG, 



ZDFLTH, ZDFSRI, ZDrLOK, 



ZDFSRD 

Background Control 

ZDFBGR 


Operaton Security 

ZDrOSR 


Operator Statistics 

ZDrSTA 


Function Object Units 

Applications Processor 

ZD.-AP 


Data Entry Processor 

ZDr DE1 

ZDFDE2. ZUFDE3, ZDFDE4 

Forms Processor 

ZDFFMI 

ZDFFM2, ZDFFM3, ZDFFM4, 



ZDFFM5 

rile Print Processor 

ZDFFP 


Tables Processor 

ZDFT3 


Utility Functions 

ZDFUT 
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Table E-2 (Cont). DEF.I Object units 


Func tion 

Specified 

Not Specified 

Suoervisor Functions 

ZDFSPl, ZDFSP2, 


• 

(ZUFPUP) 


Verification Processor 

ZBrV E 



Additionally, dummy units listed in Table E—4 are orovided so that 
specific DEE-I functions such as operator security, operator 
statistics, and oassword uodatino need not be included in the 
system. 


Table E-4. QEF-I Dummy Object Units 


Function 

Dummy Oblect Unit 

No Aoolications 

ZDFAPD 

No Data Entry 

ZDFDED 

No Form Creation 

ZDFF MU 

No rile Printing 

ZDFFPD 

No Table Creation 

ZDFTBD 

No Utilities 

ZDFUTD 

No Suoervisor 

ZDFSPD 

No Verification 

ZDFVED 

No Operator Security 

ZDFOSU 

No Operator Statistics 

ZDFSTD 

No Password Updating 

ZDFPuJ 


Not required if 
suoervisor is nor 
configured), 


To create the DEF—I system bound unit, either the real unit or the 
corresponding dummy unit must be included for each function. For 
examole, you must link either ZDFFP or ZDrrPr. 
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Data Entry Program object Units 


All data entry programs are ootionai user-supplied programs that are 
linked into one or more bound units separate from the DEF-I system 
bound unit* Table E—5 lists the object units that must be linked in 
order to orocess data entry orograms. These object units are linked 
with the data entry programs in a Linker run separate from the 
linking of the DEF-X bound unit itself. 


Table E-5. DEF-I Data Entry Program Object Units 


Function 

Ob Ject uni t 

Memory Resident 

Data Entry Program 

Direc tory 

Data Entry Program overlay 
Directors 

Data Entry Program Dope 
Vector Generator 

ZDFMR 

ZDFD1, ZDFD2, ZDFD3, ZDFD4 

ZDFDVG 


Bound Unit Organization Considerations 


Before generating a DEF-I bound unit, you should consider the 
following questions * 

. rthich DEF-I functions are required? 

. Which DEF-I functions may be overlayed? 

. Is the operator security feature required? 

. Is password updating required? 

. Are operator statistics required? 

The available DEF-I functions are as follows* 


. Aoolications Processing 
. Data Entry Processing 
. Forms Generation 
. File Printing 
. Table Generation 
. Utility Functions 
. Supervisor Functions 
. Verification Processor 


If Data Entry is configured you must also consider whether 
user-supplied data entry programs are required. 
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RESIDENT AND OVERLAYED FUNCTIONS 


Each DEF-I function may be linked as memory resident or overlayed. 
Functions linked as overlays are not necessarily available to the 
display station station operator at all times. Figure E-2 
illustrates three possible DEF-I system bound unit organizations. 

The first one is the bound unit as linked by DEF_5AMPLE,S in Figure 
e-7. Here, only the DEr-I control function is resident and the 
remaining functions are overlays. Functions which share a common 
overlay base address cannot be used concurrently. That is. it would 
not be possible to use the data entry and forms functions at the 
same time, but it is possible to use the data entry and verification 
functions concurrently. It would not be oossible to use the 
interactive and suoervisor functions at the same time because the 
data entry function is loaded into memory when the verification 
function is selected and the data entry and supervisor functions 
have a common base address. Note that the effect of Linking the 
application function so that it is never overlayed by any other 
function would be to leave it always in memory once 1t or any of the 
other functions has been used* This has the same effect as linking 
the applications function as memory resident. The si 2 e of the 
particular DEF-I system bound unit would include the sum of the 
sizes of the DEF-I control, aDOlications, data entry, and 
verification functions. 

The second bound unit organization in Figure E-2 allows more 
functions to be accessed concurrently. Here it would be possible to 
use the aoollcations, file orint, data entry, forms, and tables 
functions all at the same time. In this particular organizetion, the 
size of the bound unit is greater than the sLze of the first 
illustration but the difference is only by the size of the file 
print function. 

The third DEF-I bound unit organization in Figure E—2 would take up 
considerably less memory but available functions are limited. This 
organization would be suitable once you have created ail necessary 
forms and tables for data entry and had no further use for those or 
any other functions. 

When planning the DEF—I function overlays, you must consider which 
functions are required to run concurrently in the system and arrange 
the overiayys accordingly. Use of concurrent functions causes the 
size of the DEF-I system bound unit to increase according to the 
size of the concurrent functions. 

If a function is linked as an overlay but is not overlayed by any 
other function, it will be read into memory_when first selected and 
remain la memory for the duration of the DEr-I task group. 


I 
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DATA ENTRY PROGRAMS 


All data entry programs are user-suoolied and linked into one or 
more bound units separate from the main DEF—I system bound unite 

Data entry orograms can be made memory resident for speed of access 
or overlayed if efficient memory is not available. 

The linkage procedure for user programs is described in the Data 
Entry Facility-I User^s Guide , 


RESIDENT FUNCTIONS OVERLAY AREA FOR FUNCTIONS 



Figure £-2. DEF-I Function Resident/Overlay Organizations 
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MEMORY CONSIDERATIONS 


The following memory considerations must be keot In mind when 
deciding the DEF-I system bound unit organization. 

The amount of memory required for the DEr-I system bound unit 
includes the memory required for the resident functions plus the 
memory required for all overlayed functions that can reside in 
memory simultaneously. When all overlays start at the same base 
address, this memory size i 3 that of the largest overlay. 

When a given function is processing either as resident or as an 
overlay, all operator display stations can access that function 
concurrently (the function is reentrant). 

User-written data entry programs are linked seoarately from the 
DEr-I system bound unit and have their own overlay structure. Uo to 
four oound units of overlayed data entry orograms are suooorted. The 
user may link up to 99 different data entry overlay programs in each 
oound unit or overlay area.. The amount of memory available must be 
large enough to contain the largest data entry overlay orooram. 
User-written data entry orograms can also be linked as memory 
resident. If no, they are linked into a single, separate bound unit. 
Memory is required for the data entry program director plus the sum 
of the sizes of all user orograms uo to a maximum of 20 programs. 

Additional buffer and system memory considerations are discussed 
later in this Aooendix. 


'JEr—I System Bound Unit Creation 


Creation of the DEF-I system bound unit consists of a Linker run 
using a file with Linker directives that define four logical system 
categories^ 

. JEF-I system object units 

• OEF-I memory resident DEF-I function object units 
. JEF-I overlayed DEF-I function object units 
. JEF-I system parameters. 

Figure E-7 is a complete listing of samnle Linker directives 
required by a DEF-I system. In the linking orocedure described 
below, the directives in that listing are used to illustrate the 
text. 
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LINKING DEF-I SYSTEM OBJECT UNITS 

Only the DEF-I system object units listed in Table E-5 must be 
linKed. The remaining system object units listed In E-3 are 
internally linked and do not need to be specified. 


Table E-6. System Object Unit Linker Directives 


1-1 

Function 

Linker Directives 

System Routines* 

DEF-I Control and 
Background control 

LINKN ZDFCTL, 

ZDFBGR. ZDFLTD. ZDFIAD 


Configured 

Not Configured 

Operator Security 

LINKN ZDFOSR 

LINKN ZDFOSD 

Operator Statistics j 

LINKN ZDFSTA 

LINKN ZDFSTD 


LINKING MEMORY RESIDENT DEr-I FUNCTION OBJECT UNITS 

If a configured DEF-I function is to be memory resident or if It is 
to be omitted from the DEF-I system* a Linker directive listed in 
Table E-7 must be used. 


Table E-7. Memory Resident object Unit Linker Direct!ves(t) 

Function Memory Resident Not Configured 

Aoplications Processor LINKN ZDFAP LINKN ZDFAPD 

Data Entry Processor LINKN ZDFDE1 LINKN ZDFDED 

Forms Processor LINKN ZDFFM1 LINKN ZOFFMD 

File Print Processor LINKN ZDFFP LINKN ZDFFPD 

Tables Processor LINKN ZDFTB LINKN ZDFTBD 

Utility Functions LINKN ZDFUT LINKN ZDFUTD 

Suoervisor Functions LINKN ZDFSP1. LINKN ZDFSPD ZDFPUO 

ZDFPUP * ZDFSP2 
(See note 2) 

Verification Processor LINKN ZDFVE LINKN ZDFVED 
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NOTH5 * 


1. Several of the object units listed in Tables E-3 and E-4 for 
the functions in this table do not have to be specified in the 
LINKN directives because they are internally linked. 

2. if the suoervisor function is linked and oassword updating is 
not required, specify ZDFPUD in olace of ZOFPUP. 


LINKING DEr-I FUNCTION OVERLAY OBJECT UNITS 


LinKer directives are required to link overlayed DEF-I functions, if 
any. For each function, use Linker directives to* 

1. Name the overlay 

2. Specify the base 

3. Link the function object units 

4. Orotect the overlay iase and end addresses. 

Table S-9 lists the DEF-I system functions and the directives 
required to link each as an overlay. 


Table E-8. DEr-I Function Overlay Linker Directives 


Function 

Overlay Directives 

Application Processor 

OVLY APOLAY 

BASE - 

LINKN ZDFAP 

PROT APBASE,APENJ 

Data Entry 

OVLY DEOLAY 

BASE- 

LINKN ZDFDEl 

PROT DE3ASE,DEEND 

Forms Processor 

OVLY FMOLAY 

BASE 

LINKN ZDFFNf 

PROT FMBASE.FMEND 

File Print 

OVLY EPOLAY 

BASE- 

LINKN ZDFFP 

PROT rt>8ASE, FPEND 

Supervisor Functions 

OVLY SPOLAY 

BASE- 

LINKN ZDFSPt,ZDFPUP,ZDFSP2 

PROT SPBASE,SPEND 
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Table 5-8 (Cent)* DEF-I Function Overlay Linker Directives 


Function 

Overlay Directives 

Table Generation 


OVLY TBOLAf 

BASE —* 

LINK ZDFT8 

PROT TBBASE*TBEND 


Utility Functions 


OVLY UTOLAY 

BASE — 

LINKN ZDFUT 

PROT UTBASE*UTEND 


Verification!1) 


OVLY VEOLAY 

BASE - 

LINKN ZDFVE 

PROT VEBASE* VEEND 

1 


NOTE * 

t. The verification function reoulres data entry processor 

subroutines,, Therefore* Its base starting address must follow 
the last data entry overlay address* DEEND. 

The BASE directive must be set up according to the user reouired 
overlay structure* Refer to the Program Execution and Checkout 
manual for a full discussion of the BASE directive. 

If patches are aoplied to any DEF-I function object unit and the end 
address of that function is used as the base address for overiayed 
DEF-i functions* then the base address for that overiayed function 
should be specified as* 

[function id! END + X'50' 

where [function id3 is one of the two-character abbreviations shown 
above <> 

Each overlay has “start 16 and “end* 6 labels which must be "PROTected** 
as shown. 

Figure E-7 is a sample listing of the Linker directives necessary to 
specify the DEF-I system and function object units. 


DEFINING DEF-I SYSTEM PARAMETERS 


Additional Linker directives are required to provide DEF-I system 
parameter values* The values must be placed in the half of a word as 
illustrated. 

A complete listing of the examoles that illustrate the text is in 
Figure E-7. 
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Specifying LRNs 


The foliowing directives soecify sample logical resource numbers 
(LRNs) required for DEF—I. Unless otherwise mentioned these LRNs 
are not related to system-wide LRNs (e.g.* those in the CLM_USER 
file). 


Directive 

VDEr QKLRN*X'0]00' 
VDEF BMLRN,X'0200 y 
VDEr LOKLRN, X y 0300^ 
VDEF INILRN,X / 0500' 
VDEF L0LRN,X'00I9' 
VDEF HILRN *X y 001 k* 

VDEr CRLRNI.X'O' 

VDEF OVLRNl.X'tBOO' 
VDEF OVLRN2,X v 0 > 
VDEF OVLRN3*X'0^ 
VDEF OVLHN4,X'0' 


Comment 

/LRN OF DISK HANDLER*] 

/LRN OF BUFFER MANAGER*2 
/LRN OF DEF FILE L0CKER=3 
/LRN OF CRTJ-5 

/FIRST< *25) AND LAST (*X'JA'*2*>LRNS 

/FOR BACKGROUND AND OPERATIONS. 

2 OPERATIONS ARE ALLOWED IN THIS 
EXAMPLE. 

/LRN OF MEMORY RESIDENT PROGRAM 
DIRECTOR *0 (NO MEMORY RESIDENT 
PROGRAMS) 

/LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 1 *X'1B'*27 DECIMAL 

/LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 2*0 (OVERLAY AREA NOT USED) 

/LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 3*0 

/LRN OF DATA ENTRY PROGRAM OVERLAY 
DIRECTOR 4*0 


Note that data entry overlay directors 2 through 4 are given LRNs of 
0 because they are not being used. 

The LOLRN, HILRN arguments define the range of LRNs to execute file 
prints and applications in the background. In the example above* two 

LRNs are available which would allow two background file prints* two 
background aoplications* or one of each. 


Specifying the Number of Function Overlays 

The following directive specifies the number of OVLY directives used 
in linking the DEF-I functions. 


I 
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Directive 


Comment 


VUEr ourNo.x'oooa' 


/Number of function overlays = 3 


Specifying the Size of the CRT Screen 

The following directives specify the dimensions of the screen of the 
operator display station* The forms orocessor will not permit fields 
on a form to be created outside of the positions specified here. The 
size of the CRT screen must be specified as follows* 


Directive 
VJEr CRTC.X'0050' 

VOEF CRTL.X'0017' 


Comment 

/COLS PER CRT LINE X'50'=80 
DECIMAL 

/LINES PER CRT PACE X' 17'* l 3 
DECIMAL 


Specifying Continuous or Noncontinuous Keyin 

The following directive specifies whether keyins is continous* that 
is* woether the system will tab forward automatically between fields 
or whether the RETURN key must be entered to reach the next field. 


Pi recti ve 


Comment 


VJHF NCUNKN,X'0' /X^O' MEANS CONTINUOUS, NON X'<V 

MEANS NONCONTIGUOUS KFXIN. 


AuTCAL Argument 

This argument is required and is reserved for system use* 
V'Jdf A UTCAL, X y 0000^ /RESERVED 


CLM„jSER-Rela ted Directives 

The following directives are specified in the CLM_uSER file. 

They define the following * 

I. The LRN of the first DEF-I CRT. The value must match the 

lowest LRN value specified in the CLM_USER file for a device 
to be used as an operator display station. In the examole* the 
X^OC30'' corresponds to the (decimal) 12 in Figure E-l . 
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Directive 


Comment 


VOsr CRTLRN # X ' OC00' /LRN Or FIRST CRT DRIVER * 12 

DECIMAL 


2. The LRN of the first orinter used by DEF-I. The value must 
match the lowest LRN value specified in the CLMJJSER file for 
a printer to be used with DEr-I. In the examoie, the X'0800' 
corresoonds to the (decimal) 3 in Figure E-l. 


D1rective Comment 

VO=r PRTLRN.X'0300' /LRN Or FIRST PRINTER DRIVER 


J. The oresertce or absence of an operator console. A value of 
X'0059' (ASCII Y) In the VDEF OPCUNS directive indicates that 
a console Is oresent; a value of X'004E' (ASCII N) indicates 
that there is no console. 


Directive Comment 

VDEr OPCONS, X-'0059' /ASCII f Y, OPERATOR'S CONSOLE 

IS PRESENT 


4. The number of CRT's available as QEr-t ooerator display 

stations. Note that this number must not exceed the number of 
CRT's soecifled in the CLM.USER file. 


D1rective Comment 

VDEr CRTN() t X'0004' /NUM3ER OF CRT'S SUPPORTED 

o. The number of printers available to DEr-I. 

Direct jve Comment 

VDEr PRTNO,X'000I' /NUM3ER Or PRINTERS*! 
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Printer Formatting 

The following directives define the number of characters per line 
and the number of lines oer oage for each printer. Note that 16 
directives must be present, even if only one printer is used. 


Directive Comment 


VDEF 

PRTC1,X^0088' 

/PRINTER ) 
characters 

LINE WIDTH=136 DECIMAL 
(Hexadecimal 88) 

VDeF 

PRTU,X'003E^ 

/PRINTER 1 LINES/PAGE*62 DECIMAL 
(Hexadecimal 3E) 

VDEF 

PRTC2,X^0088' 

/PRINTER 

2 

LINE WIDTH*136 

VDEF 

PRTL2,X'003E^ 

/PRINTER 

2 

LINES/PAGE-62 

VDEF 

P RTC3,X * 0088/ 

/PRINTER 

3 

LINE WIDTH-136 

VDEF 

?RTL3,X^003E^ 

/PRINTER 

3 

LINES/PAGE-62 

VDEF 

PRTC^X'OOSS^ 

/PRINTER 

4 

LINE WIDTH-136 

VDEF 

PRTL4,X'003E' 

/PRINTER 

4 

LINES/PAGE-62 

VDEF 

PRTC5,X^0088^ 

/PRINTER 

5 

LINE WIDTH-136 

VDEF 

PRTL5,X^003E' 

/PRINTER 

5 

LINES/PAGE-62 

VDEF 

PRTC6,X'0088^ 

/PRINTER 

6 

LINE WIDTH-136 

VDEF 

PRTL6,X^003E^ 

/PRINTER 

6 

LINES/PAGE-62 

VDEF 

PRTC7,X^0088' 

/PRINTER 

7 

LINE WIDTH-I36 

VDEF 

PRTL7,X , 003£^ 

/PRINTER 

7 

LINES/PAGE-62 

VDEF 

FRTC8,X ^ 0038' 

/PRINTER 

3 

LINE WIDTH-136 

VDEF 

PRTL8,X^003E^ 

/PRINTER 

8 

LINES/PAGE-62 


Fixed Buffer Allocation 

Each active operator display station (CRT) reauires a certain amount 
of workspace, For example, each active CRT requires a constant 
memory storage area of 357 words. The remaining workspace 
requirements depend upon the function executing at the CRT and are 
provided by a set of fixed and dynamic buffers. Dynamic buffers are 
requasted as they are needed from the user pool. Fixed buffers must 
be specified using Linker directives. There are four sizes of DSF-T 
fixed buffers specified using the VDEr directive NB1, N82, N33, and 
NB5 arguments. These buffer sizes are listed in Table P-9. 
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Table E-9. DEF-I Fixed Buffer Sizes 


Buffer Argument 

Buffer Length (Words) 
DecImal 

NBI 

1024 

NB2 

256 

NB3 

Configurable 

NB5 

10 

Buffer argument NB4 is reserved. 


Depending upon the particular aoollcatlon executing at the CRT some 
of the DEF-I fixed buffers are used only temporarily and are 
returned to the DEF-I fixed buffer pool as soon as their use is 
completed. The buffers may then be used by some other ooerator 
disolay station, thus reducing the number of buffers that must be 
linked. 

Table E-IO shows the DEF-I fixed (F) and dynamic (D) buffer 
requirements for the DEF-I functions and indicates whether the 
buffers are temporarily held or are held as long as the function is 
being used. The figures given are for a given operator disolay 
station. 


Table E-IO. Fixed and Dynamic Buffer Retirements 



NBI 

1024 Wds 

N82 

256 Wds 

N 33 

Configurable 

NB5 ** 


Function 

r 

P 

m 

r 

D 

10 Wds 


DATA ENTRY 

i ★ 

I 

i 

i 

1 

As many 
needed 

as 

DATA ENTRY WITH 
TABLES 

i ★ 

1 

i 

i 

1 

As ma ny 
needed 

as 

DATA ENTRY WITH 

P RODE? AMS 

i * 

1 

i 

t 

1 

As many 
needed 

a s 

DATA ENTRY WITH 
TABLEi/PROGRAMS 

i* 

1 

i 

i 

1 

As many 
needed 

as 

DATA ENTRY - 
.MODIFICATION 

i* 

1 

i 

i 

2 

As many 
needed 

as 

DATA 

VERIFICATION 

i * 

1 

i 

i 

2 

As ma ny 
needed 

as 
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Table E-IO (Cont). Fixed and Dynamic Buffer Requirements 



CREATE A VERIFY 
TABLE 


CREATE AM 
EXTRACT TABLE 


COPY A FORM 
OR TABLE 


VIEW A FORM 
OR VERIFICATION 
TABLE 


VIER AN EXTRACT 
TABLE 


FILE PRINTING 
(FORMATTED) 


PRINT A FORM 
OR TABLE 


SHIFT F7 PRINT 


★Indicates that the buffers are used temporarily and then released, 


**NSB buffers are used for extended field (program calls, 

uooer/lower limits, tables, constants) used on the form. There is 
one NB5 required per extended field used on a form. 


General rules based uoon the above table for linking NBI, NB2, N33, 
3nd N35 size buffers are as follows* 

. For operator display stations used for data entry only use* 

1 NBI per 2 operator display stations 

2 N32 oer ooerator display station 

3 N63 per operator disolay station 

o N35 per ooerator display station per extended field on form 

• For ooerator display stations used for development (form 
creation, tables, copies, etc,)* 
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2 MSI per operator display station 
l N32 per operator display station 
l N33 per operator disjlay station 

1 NB5 per ooerator disolay station per extended field'on form 

NOTE* Attemots to orocess with insufficient buffers linked produce 
unspecified results. In most cases, an INSUFFICIENT USER 
MEMORY message will apoear on line 24 of the operator display 
station. 

The following directives define the number of buffers allocated for 
each size and the size of buffer 3. 3uffer 3 is used for the Data 
Entry buffer and contains the current data entry record. Therefore, 
the specified size must be the same as the buffer size specified 
when linking any data entry orograms. Also, the number of data 
characters the buffer will contain is twice the buffer size in words 
less lb characters for the header, (see the DEF-I User y s Guide). 


Comment 

/NUMBER OF SIZE I 8JFFERS*4 

/NUMBER Or SIZE 2 BUFFERS*4 

/NUMBER OF SIZE 3 BUFFERS*4 

/NUMBER OF SIZE 4 BUFFERS*0 

/NUM3ER OF SIZE 5 8UFFERS*40 
(hexadecimal 28) 

/SIZE OF SUFFER3 - 128 (Hex 30) 

words*256 charac ters 


Data Entry Program General Purpose Buffer 

The following directive specifies the size of the qeneral ouroose 
buffer, buffer number 6, usad by any data entry program. You must 
specify a buffer size as large as the largest general purpose buffer 
required by any data entry program that will execute on your system. 
The buffer size is specified in words, half the number of characters 
the Duffer will hold. One buffer is used for each operator disolay 
station executing a data entry program. 


Comment 

/SIZE OF DATA ENTRY PROGRAM 
/GENERAL PURPOSE 3UFF£R*32 
/(hex 20) WORDS = 64 
/CHARACTERS 


Directive 

VDEF DUPWRD,X y 0020' 


Pi rective 
VUir NBI,X'0004' 
VDEF NB2,X'0004 y 
VDEF NB3,X y 00Q4 y 
VDEF NB4,X y 0000 y 
VDEF NS5,X y 0028 y 

VDEF SB3,X'0080 y 
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First LRN 

The following directive defines the first LFN to be used by DEF-I. 
This number affects the value of the maximum LFN argument soecified 
in the soawn group command for the task group* In the following 
example, LFNs ! to 8 are available for use by data entry programs. 
Note, however, that the DEr-I LFNs may also start at J. In that 
case, the program LFNs would start following the last DEF~I LFN. 
DEF-I requires 8 LFNs per operator display station and 8 LFNs per 
background area. 


VDEF CRTLrN,X'0009' /FIRST CRT LFN-9 


Number of Background Tasks 

The following directive defines the number of background tasks to be 
run concurrently. It cannot exceed the number of CRT fs nor can It 
exceed the total number of LRNs defined by the LOLRN and HILRN 
arguments, rile printing and application programs optionally run in 
the background. File print needs a background task even when the 
print operation is not in the background. At least one background 
task must be specified. 


VDEF 3AKNO,X^0002^ /NUMBER Or BACKGROUND TASKS*2 


Assigning Volume Name 

Each of the following four directives defines two characters of the 
name of the volume which Dir-I will initially use for forms, tables, 
and data entry. The hexadecimal values for the anorooriate ASCII 
characters are specified. Only eight characters are allowed, the 
first must be circumflex (hexadecimal 5E), the eighth must be 
hexadecimal 3E. Note that the volume assignments can be changed by a 
DEF=T supervisory function, but this link specified volume name must 
be present when QEF-I is loaded. 


DIrective 


Comment 

VDEF 

SVNi,X^5E44' 

/SYSTEM 

VOLUME* * 

VDEF 

SVN2, XM546-' 

/ 

*Er 

VDEF 

SVN3,X'5752' 

/ 

*rfR 

VDEF 

SVN4,X'4B3E' 

/ 

*K> 


Specifying Password Parameters 

The following directives define the size and total number of 
passwords available and one initial password used to gain entry to 
DEF-I. Note that the initial password Is specified using five 
directives, one for each two characters, even if the password is 
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less than 10 characters long; The excess characters must be 
specified as blanks (hex 20). The directives are only required if 
the operator security feature is linked. The passwords may be 
maintained by the oassword update facility. 


Directive 

VD£r PA-SSNO.X'OOJO' 

VDEr PASS!Z.X'0004' 

VDEF PASS!,X'4445' 
VOEF PA$32,X'4633' 

VDEF PASSi.X^Eay 
VOEF PASS4,X'2Q20' 
VDiF PASS5,X'2020' 


Comment 

/NUMBER OF PASSWORD AVAILABLE*16 
(hex 10) 

/MUST BE 0 IF NO OPERATOR SECURITY 

/LENGTH Or PASSWORDS. MAXIMUM 

/SIZE IS 10 CHARACTERS 

/INITIAL PASSWORD IS DEF3.2 

/(HEX 44. 45, 46* 33* 2E* 32*ASCII 
DEF3.2) 

(HEX 2E,32*ASCII.2) 

/(HEX 20*BLANK) 


Specifying Password Accessible Functions 

The following directive specifies the functions which may be 
accessed using the first password soecified above. If any additional 
passwords are required the initial password must be given access to 
the supervisor function. The functions available are soecified hy 
the first 9 oits of the 16 bit, 4 hex character argument. If the bit 
value for the associated function is zero, the function is not 
available* if the bit value is one, the function is available. 

Table £-11 lists the bits and their associated functions. Bit 0 is 
the high order bit. 


Table 5-11. Accessible Function SoecifIcation 


sit 

Function 



0 

Aop lica tlons 

i 

Data Entry 

2 

Forms 

3 

File Print 

4 

(Reserved) 

5 

Sup er vi so r 

6 

Tables 

7 

Utllities 

3 

Verification 
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Thus, a directive specifying that all functions are available using 
the first password would be as follows* This directive content is 
recommended. 


Directive Comment 

VOlt PASSFN,X'FFFF' /ALL FUNCTIONS ARE AVAILABLE 


Specifying Allowable Ooerator Functions 

The following directives determine which OEF-I functions can be 
selected by the operator display station users. If X'OOOO' is 
entered for any of these directives, the corresponding DEF-I 
function cannot be used by any data entry ooerator. If the function 
is to be allowed, the hexadecimal value of the appropriate ASCII 
character must be specified, as illustrated in the example. 


Directive 


Comment 


VOSr 

APPL,X'00*]' 

/AI LOW 

APPLICATI 0NS*A 

VOlt 

DATA,X'0044' 

/At urn 

DATA ENTRY-D 

VDiF 

FORM,X'004A' 

/ALLOW 

FORM CREATE*F 

V )£F 

INTRA,X'0030' 

/RESERVED 

VOlt 

FILPSN.X'0050' 

/ALLOW 

FILE PRINT*P 

V j£r 

SUP£R,X'0053' 

/ALLOW 

SUPERVISOR FUNCTION-S 

VDEF 

TABLE,X'0054' 

/ALLOW 

TABLES CREATE=T 

VOlr 

! JTIL,X'0055' 

/AILOW 

UTILITIES*^ 

VOEr 

VERIr,X'0056' 

/ALLOW 

VERIFICATIONS 

Printer 

Assignments 




The following directives determine the initial orinter assignments 
for each CRT. All 20 assignments must be made, even though fewer 
than 20 CRT's are available. Printer assignments may be temporarily 
changed by a Dcr-I Supervisory Function. 


Direct!ve Comment 


VDEF 

PORT!,X'0001' 

/CRT 

1 

JSES 

PRINTER 

VOlr 

PCRT2»X'000I' 

/CRT 

2 

USES 

PRINTER 

V'Olt 

PCRT3,X'0001' 

/CRT 

3 

USES 

PRINTER 

VOlt 

PCRT4,X'00Ql' 

/CRT 

4 

USES 

PRINTER 

VOlr 

PCRT5, X'0001' 

/CRT 

5 

USES 

PRINTER 

VXEr 

PCRT6,X'000J' 

/CRT 

6 

USES 

PRINTER 

VDEF 

PCRT7,X'000I' 

/CRT 

7 

USES 

PRINTER 

VOlr 

PCRT3,X'0001' 

/CRT 

8 

USES 

PRINTER 

VOlr 

PCRT9,X'OOG!' 

/CRT 

9 

USES 

PRINTER 

VOlt 

PCRTI 0, X' 0001' 

/CRT 

10 USES 

PRINTER 

VOlt 

PCRTI I.X'OOOI' 

/CRT 

1 1 

USES 

PRINTER 

VOlt 

PCRTI2,X'0001' 

/CRT 

12 USES 

PRINTER 


♦ 
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VDEr 

PORT)3,X'0001 

✓ 

/CRT 

13 

USES 

PRINTER 


VJir 

PCRTM.X'0001 

✓ 

/CRT 

14 

USES 

PRINTER 


V Jir 

PCRT15,X' 0001 

✓ 

/CRT 

15 

USES 

PRINTER 


VJir 

PCRT16,X / 0001 

✓ 

/CRT 

16 

USES 

PRINTER 


VJir 

PCRTI 7, X y 0001 

/ 

/CRT 

17 

USES 

PRINTER 


VUSr 

PCRT18,X'00QI 

/ 

/CRT 

1 8 

USES 

PRINTER 


VJir 

PCRTI 9. X'0001 

y 

/CRT 

1 9 

USES 

PRINTER 


V Jar 

PCRT20,X'000t 

/ 

/CRT 

20 

USES 

PRINTER 



data entry *)verlay Areas 

The following directives define which of the data entry overlay 
areas is to be used by eacn operator display station for execution 
of overlayed data entry programs. The hexadecimal value is the 
number of the data entry overlay area to be used and must be in the 
range 000i through 0004. 




As with the printer assignments* the data entry overlay area 
assignments must be made for 20 CRT's* even though fewer are 
available. Note that these overlays are different from the DEF-I 
function overlay area. 


Direc ti ve 

VOcr OCRTJ .X'OOOl' 
VUEr 0CRT2 „X'0001' 
VJEF OCRT3*X'000I' 
VJEF OCRT4*X'OOOl' 
VJEr OCRT5 , X' 3001' 
VJEF 0CRT6 ,X'OOO t' 
VJEF 0CRT7,X'0001' 
VJEF OCRT3,X'0001' 
VJEF OCRT9 *X'000!' 
VJEF OCRTI 0* X' 0001' 
VJEF OCRTJ 1*X'000J' 
VJEF OCRTI2*X'0001' 
VJEr OCRTI 3, X' 0001 ' 
VJEF OCRTI4,X'0001' 
VJEr OCRTI5*X'0001' 
VJEr OCRTIA * X'0001' 
VJEr OCRTI7,X'000!' 
VJEF 'OCRTI 9, X'000 l' 
VJEr OCRT 1 9 , X' 0001' 
VJEr OCHT20* X'0001' 


Comment 

/CRT I USES OVERLAY J 
/CRT 2 USES OVERLAY 1 
/CRT 3 USES OVERLAY I 
/CRT 4 USES OVERLAY 1 
/CRT 5 USES OVERLAY 1 
/CRT A USES OVERLAY l 
/CRT 7 USES OVERLAY 1 
/CRT 3 USES OVERLAY I 
/CRT 9 USES OVERLAY I 


/CRT 

10 

USES 

OVERLAY 


/CRT 

11 

USES 

OVERLAY 


/CRT 

12 

UScS 

OVERLAY 


/CRT 

13 

USES 

OVERLAY 


/CRT 

14 

USES 

OVERLAY 


/CRT 

15 

USES 

OVERLAY 


/CRT 

16 

USES 

OVERLAY 


/CRT 

1 7 

USES 

OVERLAY 


/CRT 

13 

USES 

OVERLAY 


/CRT 

19 

USES 

OVERLAY 


/CRT 

20 

USES 

OVERLAY 



Comoieting tne Link 

The link must be compieted with the QUIT directive. The MAR 
directive is optional. 

MAP 

QUIT 


JROUP GENERATION FOR A DEF-I SYSTEM 


Use tne 5G (Spawn Group) command to spawn a task group In which 
JEF-I can operate. A complete descriotlon of the SG command appears 
in the Commands manual. 


Task Group Considerations 


The task group in which DEE-I is to execute requires the following 
specifications for the maximum LRN and LFNt 

LRN - the value must be greater than the maximum LRN used in the 
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START.UP.SC filers CT (Create Task) commands. 

LrN - the value must be equal to or greater than the result of 
the following algorithm* 

base LFN specified In the Linker VOEF CRTLFN directive 

♦ 8 x (number of CRT'-s) 

+ 8 x (number of bac<ground tasks allowed at one time) 

+ l if operator statistics are required 

* the number of LFNs required by data entry programs and 
aoolications. 

Example of a Spawn Croup Command 

For examole, a typical GEr-I SG (Spawn Grouo) command might be as 
follows * 

SG AA Q.E.F. 0 !CONSOLE -LRN/28 -LFN 58 -P(X>L AB -WD DEFDIR 

SG 

Pie spawn group command 
AA 

The id assigned to this task grouo 
O.S.F. 

The user^ld assigned 

0 

Relative oriority level for this task group's lead task 
!CONSOLE 

Input path for commands and user inout 
-LRN 28 

Highest logical resource number that will be referred to by any 
task In the task grouo 

-LF‘I 58 

Highest logical file number used by any task In the spawned 
task grouo 
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-p (X)L A3 


Name of the memory pool from which ail dynamic memory required 
Dy the task grouo is to be taken 

-NJ DEFDIR 

The working directory to be used by the task group*. The 
directory used should have a START_UP.EC file containing the CT 
(Create Task) command to activate DEF-I. 

The LRN in the example Is greater than the maximum LRN used in the 
START_UP.EC file's CT (Create Task) command below*, 

The LrN value of S3 is greater than the value determined by the 
following calculation* 

LFN = 6x4 (terminals) + 8x2 (background tasks) + 9 (base LFN* 
specified in Linker VDEF CRTLFN directive) * 57 


DEr 3TART_,UP.EC FILE (TASK GENERATION) 


once the SG (Spawn Group) command has baen executed, several OEF-I 
tasks must be created and activated. Appropriate CT (Create Task) 
commands may be stored in a START_UP.EC file immediately subordinate 
to the initial working directory of the spawned task group or they 
may be soecified individually at initialization time. STARTJJP.EC 
files are discussed in the System Concept manual . 


Create Task 


Tasks are created by CT (Create Task) commands as follows* 

CT Ir.i rel_level ctl_arg 

Irn is the logical resource number by which the task group 
refers to the task 

rei_level is the priority level of the task 
ctl_arg is either the control argument 
-EFN root?symbolic-start-address 

°r 

-SHARE lrn symbollc-start-address 

where the —EFN argument includes the name of the bound 
unit root segment (here DEr-I) followed by a Question 
mark, followed b/ the symbollc-start-address (entry point) 
within the root segment* DcF initialization (INFNTR). 
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Pie -SHARE control arguments specify the additional entry 
points which the DEr bound unit, and the LRN used is that 
a ssocla ted with tie initialization (INFNTR) entry point. 


RELATIVE LEVEL REQUIREMENTS 


The CT (create task) command Drtority level requirements for DEr-I 
tasks are shown in Table 5—12. 


Table E-12, DEr-I Relative Priority Level Requirements 


Relative 

Level 

Symbolic-Start-Address 

De scri ption 

t 

DSHTAS 

DEF Disk Handler 

2 

D3ENT 

DSF Suffer Manager 

3 

LOCKQI 

DEF rile Lock Routine 

0 

INFNTR 

DEr Ini t ia li za tlon/CRT #1 



Control 

5-n 

CENTRY 

DEr CRT #2 (and uo) Control 

rt+ i 

(none) 

DEF Background Functions 

H+IJ1+ 1 

C0BMR1 if memory resident 

Optional for Data Entry 


COBOVI is overlay area 1 

Programs 


C030V2 is overlay area 2 



COBOV3 is overlay area 3 j 



C0&0V4 is overlay area 4 



In this examole CENTRY, background tasks, and data entry programs 
are not given relative level values because one CT (Create Task) 
commanJ is required oer CRT, background task, and bound unit for 
lata entry orograms. Mote that a maximum of four overlay areas and 
one memory resident bound unit for data entry orograms may be 
specified, Note also that these are minimum relative level 
requirements within DEF-I and do not reflect any other LRNs within 
the task group. 
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Samo1s START_UR.EC File 


The commands listed in Figure E-3 are typical for a DEf-I 
START_JR.EC file. The filename is ~ZSYS7i>DEfDlR>START_UR.EC e 


GNU »Dfe^DIR 

CT S 6 “EF*h OfeFYIHHITfi 
CT I I -SHAte 5 DSKTAS 
CT 2 2 -SHAJte 5 DbbNT 
CT 2 3 “SHAfe b LUCkOI 
CT 6 6 -SHAffe 5 GENTRY 
CT 7 7 -SHARe b GENTRY 
CT B B -SHAHe b GENTRY 
CT 25 25 -SHARE 5 
CT 26 26 -SHARE 5 
CT 27 27 -feKV ENTRY! 7C0BUVI 
RON 
ETR 5 
&C 


Figure E-3. Sample DEF-I STARTUP.EC File 


In this example, DEF-I has the following* 

. 4 CRT'S 

. 2 background (file print/aoplication) tasks. 

. I data entry oregram overlay area named ENTRY! 

The name of the DEF-I bound unit is DEF. 


( 1 ) 

n - Last relative level used for CRT 
m - Number of backgroud tasks created. 
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SAMPLE SYSTEM FILE STRDCTURE 


Figure S-4 Illustrates the path structure of the DEF-I related 
system files, as they are suDolied on the release media (the 
directory root name ~ZSYS7I indicates a mass storage unit). 

Included are the samole CIM_USER file, CLM_SAMPLE the samole DEF_I 
linicer directive file DEF.SAMPLE.S, IEF_SAMPLE.S, and all DEF-I 
required object units. 

Figure E-5 illustrates a typical path structure of DEF-I related 
system files once the DEF-I system has been built. The following 
files have been added to those shown in Figure E-4. 

. The CLM„USER file (for example, the file in Figure S-l). This 
is olaced in the directory SID, 

. The DEF-1 soawn group command contained in an EC file. The file 
is illustrated in Figure E-rf. Note that this is directly under 
the system root, 

• The DEF-I linker directives used to create the bound unit 
called DEFJJSERS.S. This file is under the directory ZDRT, 

. The DIF-I bound unit called DEF, 

. The STA3TJJP.SC that creates the DSF-t tasks is in the QEFDIR 
directory. An example of the startuD file is illustrated in 
Figure E-3. 

. The bound units for the DEr-I data entry programs. 

The ussr-created DEF-I and date entry orogram hound units and the 
user-created DEF START_UP.£C are in a user-created directory QEFDIR, 

Note that this set of files, naming conventions, and file paths is 
used as an illustration only. 
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~ZSYS71 


ZBRT 


CLM USER 


ZDFCTLoO 


DEF DEJECT 
UNITS 


ZOFVED.OJ 


ZDFDVGjP 

ZDFMR.0 


ZGFD1.0 

ZDFD2.0 

ZDFD3.0 


OBJECT UNITS 
FOR DAT A- ENTRY 
PROGRAMS 


ZDFD4.0 


DEF SAMPLED 


Figure E-4 


Paths of System Files 



23YS71 



*Urar grafted GlM 

*Uwr~cf*ftad LINKER dkactfen lor DEF bound unit 
*OEF bound unit 

*EC fflo that ip wn a OEF group in working diractory DEFOIR 

•START—UFSC fUg that er u m OiF t«ta and iuuaa group raody-on murage 

f Ufr piprt data entry program (mo the Data Entry Facility Om'% Guida*) 


Figure E-5. Sample Disk Organization of System and User DEF-1 Ftl 
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&P * SAMPLE bwUUr bO inrj * 

SG A A O.E.F. y >SPU>Cti'4&ULI: “LMm « -LFN be -HtjuL AH -f.'j »utK> J * 
&U 


Figure E-A. Sarooe DEF-I SPAM GROUP EC File 


Operator Startup Actions 


After all the preparatory procedures described in this section are 
completed and checked out, a DEF-I system can be started up by 
following a two-step procedure. Before presenting the procedure, the 
files that are required to be on disk are described! 

. A CLM_USER file soecific to DEF-I under the directory SID 

. Bound units for the DEF-I system and user data entry programs. 
In the sample disk organization in Fiaure E-5, they are named 
■)Er and ENTRY!, 

. A START_UP.EC file in the working directory to create DEF-I 
tasks and start executing at the proper entry point. 

In figure E-5, the file STARTsUp,EC is in sample working 
directory DEF’JIR. 

. An EC file to spawn a group for DEF-I, for example, DEF.EC in 
Figure E-5, 

the operator actions are then* 

I. Bootstrap the system software 
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2. Enter the following command at the ooerator terminal* 

SC DEF 

A task group is created and the command processor loaded. The 
START_UP.EC files are then executed. They create and load the 
tasks of the DEF-1 system, and then start execution of the 
initial DEF-I task, DEF7INFNTR, in the sample START_UP.EC file 
in Figure E-3. 


SAMPLE LINKER DIRECTIVE FILES 


Figure E-7 is a listing with suoolied samole argument values, of all 
the Linker directives required to link a DEF-1 system. 



/ LINKER COMMANDS FOR DEF 3,2 (FOR NON-RESIDENT SYSTEM) 


LIB »ZDRT 
L1NKN ZDFCTL 
LINKN ZDFIAO 
LINKN ZDFLTO 
LINKN ZDFQStf 
LINKN ZDFB6R 
LINKN ZDFSTA 
/ 

OVLV APOLAY 

BASE S 
LINKN ZDFAP 
PROT APBASEir APEND 
OVLY 6E0LAY 
BASE APEND+X'l* 
LINKN ZDFDEI 
PROT DEBASE r'DEEND 
OVLY FMOLAY 
BASE APENO+X'l* 
LINKN ZPFFMi 
PROT FMSASEfFMEND 
OVLY FPOLAY 
BASE APEN0+X'1 * 
LINKN ZDFFP 
PROT FPBAS£#FPEND 
OVLY SPOLAY 
BASE APEND+X*l* 


/ LIBRARY OF OBJECT MODULES 
/ DCF SYSTEM ROUTINES 
/ REQUIRED FOR OEF SYSTEM 
/ REQUIRED FOR DEF SYSTEM 
/ OPERATOR SECURITY 
/ BACK6ROUND CONTROL 
/ OPERATOR STATISTICS 
/ DEF FUNCTION OVERLAYS 
/ APPLICATIONS OVERLAY 
/ STARTS AFTER END OF ROOT 
/ LINK APPLICATIONS 
/ PROTECT START/ENO ADDRESS 
/ OVERLAY DATA ENTRY 
/ START AFTER END OF APPLICATIONS 
/ LINK DATA ENTRY 
/ PROTECT START/END ADORESS 
/ FORMS PROCESSOR OVERLAY 
/ STARTS AFTER END OF APPLICATIONS 
/ LINK FORMS PROCESSOR 
/ PROTECT START/END ADDRESS 
/ FILE PRINT PROCESSOR OVERLAY 
/ STARTS AFTER END OF APPLICATIONS 
/ LINK FILE PRINT PROCESSOR 
/ PROTECT START/END ADDRESS 
/ SUPERVISOR FUNCTIONS OVERLAY 
/ STARTS AFTER ENO OF APPLICATIONS 


LINKN ZDFSPI e 2DFPUP;ZDF3P2 / LINK SUPERVISOR/PnRD UPDATE 


PROT SPBASErSPEND 
OVLY TBOLAY 
BASE APEND+X'l* 
LINKN ZOFTB 
PROT TBSASEiTSEND 
OVLY UTOLAY 
BASE APEND+X*I * 
LINKN ZDFUT 
PROT UTBASEfUTEND 
OVLY VEOLAY 
BASE DEEND*X'SQ* 
LINKN ZDFVE 
PRO? VEBASErVEENO 


/ PROTECT START/END ADORESS 
/ TABLES PROCESSOR OVERLAY 
/ STARTS AFTER END OF APPLICATIONS 
/ LINK TABLES PROCESSOR 
/ PROTECT START/END ADDRESS 
/ UTILITIES PROCESSOR OVERLAY 
/ STARTS AFTER END OF APPLICATIONS 
/ LINK UTILITIES PROCESSOR 
/ PROTECT START/ENO ADORESS 
/. VERIFICATION PROCESSOR OVERLAY 
/ STARTS AFTER DATA ENTRY 
/ LINK VERIFICATION PROCESSOR 
/ PROTECT START/END ADDRESS 


/********«********•********•< 


VOEF DKLRN»X p 6I00' 
VDEF BMLRN*X'0200* 
VDEF LOKLRN,X*O3O0' 
VDEF INILRN,X C ©500 <! 
VDEF LOLRNtX'eOiR*’ 
VDEF HILRNfX^OOiA p 
VDEF CRLRNiX'0000® 
VDEF OVLRNl f X e IBO0* 
VDEF 0VLRN2*X'OOOO* 
VDEF OVLRNSfX'OOOO* 
VDEF OVLRNA*X'0OO0*’ 
/ 

VDEF QLYNQt X *S* 


/ DEF SYSTEM LRNS 
/ LRN OF OISK HANOLER 
/ LRN OF BUFFER MANAGER 
/ LRN OF FILE LOCKER 
/ LRN OF CRT 1 (INITIALIZATION LEVEL) 

/ LON LRN AVAIL FOR IEF /BACKGROUND 
/ HIGH LRN AVAIL FUR 2EF/BACKGROUNO 
/ LRN OF D.E. MEM. RESIDENT PROGRAM OXRECTOR 
/ LRN OF O.E. OVERLAY DIRECTOR I 

/ LRN OF D.E. OVERLAY DIRECTOR 2 

/ LRN OF O.E. OVERLAY DIRECTOR 3 

/ LRN OF D.E. OVERLAY DIRECTOR 4 

/ NUMBER OF FUNCTIONS OVERLAYED 


Figure E-7. Samole DEF-I Linker Directive File 
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VOEF CRTC# X'0050' / COLS PER CRT LINE 

VOEF CRTL# X'OO 17' / LINES PER CRT PACE 

VDEF NCQNKN# X'O' / 0 * CONTINUOUS# NON 0 * NON CONTINUOUS KEY.IN 


VDEF AUTCAL#X'QOOO' 
/ 

VOEF CRTLRN# X'OCOO' 
VOEF PRTLRN#X'0800' 
VOEF 0PC0NS#X'S9' 
VOEF CRTNQ#X'0004' 
VOEF PRTNQ# X'OOQ1' 

/ 

VOEF PRTC1#X'00S8' 
VOEF PRTLl# X'003E' 
VDEF PRTC2#X'0O86* 
VOEF PRTL2#X'0Q3E' 
VOEF PRTC3#X'0086' 
VOEF PRTL3#X'003E' 
VOEF PRTC4# X*0088' 
VOEF PRTL4# X'OOSE' 
VOEF PRTC5# X'0088' 
VOEF PRTL5#X'003E' 
VDEF PRTC6#X'0088' 
VOEF PRTL6#X*003E' 
VOEF PRTC7»X'0O88' 
VOEF PRTL7»X'003E' 
VDEF PRTC6# X'0086' 
VOEF PRTL8#X'003E' 

/ 

VOEF N81#X'0004' 
VDEF N82# X'0004' 
VOEF 383#X*0080' 
VOEF N63# X'0004' 
VOEF N04# X'OOOQ' 
VOEF NBS# X'0028' 
VOEF OUPMRO# X *0020' 
/ 

VOEF CRTLFN#X'0009' 
VOEF 6AKNQ#X'0002' 

/ 

VOEF SVNl#X'5E44' 
VOEF 3VN2# X'4546' 
VDEF SVN3#X'5752' 
VOEF SVN4 pX r 4B3C' 

/ 

VOEF PA33NO# X'001 O' 
VOEF P<3SIZ#X'0006' 
VOEF PASSl# X'4445' 
VOEF PASS2#X'4633' 
VOEF PA3S3# X'2E32' 
VOEF PA334#X'2020' 
VOEF PASSb# X'2020' 
VOEF PA3SFN,X'FFFF ' 
/ 

/ 

/ 

/ 


/ RE3ERVE0 

/ REFERENCES TO LRN'S IN CLM.USEH 
/ LRN OF CRT 1 DRIVER 
/ LRN OF PRINTER t ORIVER 
/ 59 s OP. CONSOLE# 4E * NO UP, CONSOLE 
/ TOTAL NUMBER OF CRTS 
/ NUMBER OF PRINTERS CONFIGURED 
/ PARAMETERS TO DEFINE PRINTERS 
/ PRINTER I LINE NIOTH 
/ PRINTER 1 LINES PER PAGE 
/ PRINTER 2 LINE NIOTH 
/ PRINTER 2 LINES PER PAGE 
/ PRINTER 3 LINE NIOTH 
/ PRINTER 3 LINES PER PAGE 
/ PRINTER 4 LINE NIOTH 
/ PRINTER 4 LINES PER PAGE 
/ PRINTER 5 LINE NIOTH 
/ PRINTER 5 LINES PER PAGE 
/ PRINTER 6 LINE NIOTH 
/ PRINTER 6 LINES PER PAGE 
/ PRINTER 7 LINE NIOTH 
/ PRINTER 7 LINES PER PAGE 
/ PRINTER 8 LINE NIOTH 
/ PRINTER 8 LINES PER PAGE 
/ BUFFER ALLOCATIONS 
/ NO. OF SIZE 1 SUFFERS 
/ NO. OF SIZE 2 BUFFERS 
/ SIZE OF DATA ENTRY BUFFER 
/ NO. OF SIZE 3 BUFFERS 
/ NO. OF SIZE 4 SUFFERS 
/ NO. OF SIZE 5 BUFFERS 
/ SIZE OF GENERAL PURPUSE BUFFER 

/ FIRST LFN AVAILABLE TO OEF 
/ NUMBER OF BACKGROUND TASKS 
/ OEF SYSTEM VULUME NAME 

/ SYSTEM VOLUME IS t- *0 

/ EF 

/ N« 

/ K» 

/ PARAMETERS TO OEFINE SYSTEM PASSnOROS 
/ NO. OF PASSNOROS (sO IF NO OPERATOR SECURITY) 
/ LENGTH OF PASSnORO 
/ INITIAL PASSnORO a 0EF3.2 


/ FUNCTIONS FOR INITIAL PASSNORO 

BIT 0 = AP# BIT 1 a DE# BIT 2 a FN, 

BIT 3 * FP# BIT 4 * CREStRVEO)# BIT 5 * 9P# 

BIT 6 a TB# SIT 7 a uT, BIT 8 = VE 

/ FUNCTION LIST CO a NOT CONFIGURED) 


Figure z-I (Lone). Sample DEF-1 Linker Jirective rile 
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VDKF APPL*X*41* 
VDEF DATA,X*44* 
VDEF F0RM,X'4b* 
VOEF INTRA,X*00* 
VDEF FILPRN,X*50* 
VDEF 3UPER»X*5J* 
VD£F_TABLE*X*54* 
VDEF UTILr X *55' 
VOEF VERIF»X*5A* 

/ 


/ APPLICATIONS 
/ DATA ENTRY 
/ FORM CREATION 
/ RESERVED 
/ FILE PRINT 
/ SUPERVISOR 
/ TARLES 
/ UTILITIES 
/ VERIFICATION 

/ PRINTER ASSIGNMENTS FOR EACH CRT 


VDEF 

PCRTl,X*OOOt* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

1 

VDEF 

PCRT2,X*00©1' 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

2 

VDEF 

PCRT3# X *0001 * 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

3 

VDEF 

PCRT4?X*0©01* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

4 

VOEF 

PCRTSfX'OOOl* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

5 

VOEF 

PCRTb*X*0001* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

6 

VOEF 

PCRT7#X*0001* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

7 

VOEF 

PCRT8eX*0001* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

S 

VOEF 

PCRTOfX'0001* 

A 

■PRINTER 

ASSIGNMENT 

FOR 

CRT 

9 

VOEF 

PCRTlOpX'OOO l * 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

to 

VOEF 

PCRTIWX'OOOl* 

/ 

PRINTER 

ASSIGNMENT 

FUR 

CRT 

U 

VOEF 

PCRT12#X*000t* 

/ 

PRINTER 

ASSIGNMENT 

FUR 

CRT 

12 

VDEF 

PCRT13*X *0001 * 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

13 

VOEF 

PCRTi4#X*000i* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

14 

VDEF 

PCRTlSfX'OOOI* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

15 

VDEF 

PCRTlb? X *0001 * 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

lb 

VDEF 

PCRT17?X*0001* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

17 

VOEF 

PCRT18# X*000i* 

/ 

PRINTER 

assignment 

FOR 

CRT 

18 

VOEF 

PCRT19,X*00©1* 

✓ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

19 

VOEF 

PCRT2O,X*OO0i* 

/ 

PRINTER 

ASSIGNMENT 

FOR 

CRT 

20 

/ 


/ 

OVERLAY 

DIRECTOR ASSIGNMENT 

PER CRT 


VOEF 

OCRU,X*OOOi* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

1 

VOEF 

OCRT2*X*0001* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

2 

VOEF 

OCRT3fX*0001* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

3 

VOEF 

OCRTOfX'OOOl* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

4 

VOEF 

OCRTS»X*0001* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

5 

VOEF 

OCRTb«X*OOOt* 

/ 

overlay 

area 

FOR 

CRT 

6 

VOEF 

OCRT7»X*OOOt* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

7 

VDEF 

QCRTBf X *0001 * 

/ 

overlay 

AREA 

FOR 

CRT 

8 

VOEF 

OCRT9,X*0001* 

/ 

overlay 

area 

FOR 

CRT 

9 

VOEF 

OCRTIO* X*OOQ1 * 

/ 

overlay 

AREA 

FOR 

CRT 

10 

VOEF 

OCRTiUX*0001* 

/ 

overlay 

AREA 

FOR 

CRT 

11 

VOEF 

0CRT12* X*O001 * 

/ 

overlay 

AREA 

FOR 

CRT 

12 

VOEF 

UCRT13,X*0001* 

f 

OVERLAY 

AREA 

FOR 

CHT 

13 

VOEF 

QCRT14 p X* 0001 * 

/ 

OVERLAY 

AREA 

FOR 

CRT 

14 

VDEF 

UCRT15»X*0001* 

t 

overlay 

AREA 

FOR 

CRT 

15 

VOEF 

OCRTlbfX'OOOl* 

e 

OVERLAY 

AREA 

FOR 

CRT 

lb 

VOEF 

OCRTU^X'OOOl* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

17 

VOEF 

OCRU8,X*00©i* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

18 

VDEF 

0CRT19»X*OOO1* 

/ 

OVERLAY 

AREA 

FOR 

CRT 

19 

VOEF 

QCRT20;X *0001 * 

/ 

OVERLAY 

AREA 

FOR 

CRT 

20 


MAP 

QUIT 


rigura E—7 (Cont)* Savoie DEF-I Linker Directive riie 
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APPENDIX F 


REMOTE BATCH FACILITY/66 


CONFIGURATION 


After the GCOS 6 MOD 400 software has been initially loaded by a 
stage I system startup, you must define a file of input directives, 
calleJ the CLM^USER file, for the Configuration Load .Manager (CLM). 
This file will contain the device symbolic names, communications 
arguments, and memory oool assignments necessary to use 3C0S 6 MOO 
400 software on your hardware system. 

Any future changes to the Remote Batch facility configuration are 
made by editing the CL'OJSER directive file to reflect these 
changes. 


Configuration Directives 


To create a Remote Batch Facility with Remote Computer Interface 
(ROD, you must specialize your GCOS 4 MOD 400 system software by 
providing the necessary configuration directives. 

NOTE* Only information specifically reouired to create an RCI Remote 
Batch Facility is provided. Full descriptions of configuration 
directives are given in previous sections of this manual. 


DIRECTIVES APPLICABLE TO RCI 

SYS -*0,100,, I 0,tsa,irb 

The olan argument must he >2. 
Suggested values for tsa* 

30 for RCI 

Suggested values for Irb* 

60 for RCI 


F-01 



This directive is used in the normal manner* l.e., it must 
precede the LPHn directives and soecify the communications 
interrupt level. Both the communications interrupt level and the 
normal mode level should be the highest priority hardware levels 
in the system to ensure satisfactory operation. 

Recommended levels are 7 or S in the COMM directive and 8 or 9 in 
the seco.id argument of all LPHn directives (see below). 

ACU Irn,level .X-'acu^channel 't »^phone„^l IE ,/phone„#2 x JE ,... 3 

This directive is used in the normal manner to configure the 
optional Auto Call Unit for automatic dialing see section VI. 

MEMPOOL S vv size 

The Remote Batch Facility requires a system memory pool size of 
9200 words. 

For example, if your configuration requires 5500 words for system 
functions and 9200 words for the Remote Batch Facility, you would 
specify* 


MEMPOOL S,,14700 


LDBU 2ERRST 


You must include this directive in your CLM file if you wish to 
collect oeripheral device or memory error statistics* Error logging 
configuration is fully described elsewhere in this manual. Error 
logging procedures are described in the Operator's Guide . 




Example of Remote Batch Configuration Directives 


The following directives give configuration information for a Remote 
Batch Facility having four RCI streams. 


MSMPOOL S,,16000 
MEMPOOL ,AB,* 

Ct)'AM 8 

RCI 32,10.X'FCOO' 

DEVICE RCI00,32,1O.X'FCOO',LINE32 
RCI 33,10,X'FC80-' 

DEVICE RCI01,33,10,X'FC80',LINE33 
LDBU 2ERRST 


001T* 

NOTE* The bound unit ZQRCI must reside in directory SID of the root 
directory* The LDBU 2E.RRST directive allows the user to 
configure error logging, as described in Appendix P. Using 
this CLM file, the user may designate his host link by one of 
the following* 

RBT 32 

RBT !LINE32 

R3T >SPD>LINE32 


INITIALIZATION 


Once configuration is complete, you can execute an RBT in the task 
group $H or create your own task grouo. If multiple terminals are 
used, there must be a task grouo for each terminal. The different 
methods that can be used to create a task group are described below. 
Whether you use $H or create your own group, you must also assign 
devices/files, modify external switches if necessary, and invoke the 
task group. 
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Using the $H Task Orouo 


To use the CII HONEYWELL BULL $H task group, enter* 

EC GROUP$H(C/R) 

The command file creates the task group. 


Initializing with the Spawn Group Command 


Use the Spawn Jrouo (SG) command to create your own task qrouo in 
which the remote batch terminal can operate. A complete descriDtion 
of the SG command can be found in the Commands manual. 

The following is an example of the SG command used to create an R8T 
task grouo* 

SG A1 SMITH.RBT.OPR 2 'CONSOLE -OUT 'CONSOLE -POOL AB 
-WD RSTJ3IR -LRN 2 


SG 


The Spawn Group command. 


A I 

The id assigned to this tas< group. 
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SMITd.RBT.OPR 

The user_id assigned 


2 


Relative priority level for this task group; each RBT task group 
you soawn must be assiqned a unique priority level. 

ICONSOLE 

Input path for commands and user input. 

-OUT ICONSOLE 

File that is to receive user outout and error output* 

-FOOL AB 

Name of the memory pool from which all dynamic memory recuired by 
the task group is to be taken. 

-WO R3TJDIR 

The working directory to be used by the task grouo. The directory 
used should have a START-UP.SC file containing the Ready On CRON) 
conmand. This command causes the system to l^sue a ready message 
when the task grouo has been created. 

-LRN 2 

Two Logical Resource Numbers (LRN) are needed by RBT. This number 
should increase if there are any other requirements for this task 
group. 


MAKING INITIAL DEVICE ASSIGNMENTS 


Once the task group has been created, the inout and outDut files are 
assigned to devices by using the ASSOCIATE command. The format for 
the command is* 


ASSOC lfn path_name (C/R) 

ifn is* 

1 - input file 

2 - print file 

3 - ounch file 

The following is an example of the typeins* 

A3SOC I !CDf?00 
ASSOC 2 !LPTOO 
ASSOC 3 !MT900>vol>flie 
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The first line assigns the input file to card reader CDHQO. The 
second line assigns the print file to line printer LPTOQ. The third 
line assigns the punch file to magnetic tane unit MTVOO. Vol and 
file must be given names b/ which the/ can be accessed. 


MOJIr/lNG EXTERNAL SWITCHES 


The External Switch Word (ESN) should be set, if desired. The ESW 
should first he set to all zeros and then the desired bits turned 
on. Tne format for the typein Is* 

MSW -ALL OFF -ON nn...n(C/R) 

.M$W - Command to modify ESN 

-ALL OFF - Turn off all ESN bits 

-ON - Turn on the following bits 

n - Pie bit (hexadecimal digit) that is 
to be turned on 

The following is a breakdown of the 
bit in the External Switch Word* 


3it, On 


Off 


0 LIST NOLIST 

1 PUNCH NOPJNCH 

2 AJTOCALL NOAJTOCALL 

3 Reserved for system use 

4 STATS NOSTATS 

5 ASCII (READ) U'BCU 

A Reserved for system use 

3 LrN 3 out ASCII LFN 3 out VBT 
9 \ 

A ] 

B / 

C) Reserved for system use 

d\ 

c 1 


default values can be used for ESW settings* bits 0 and I will be 
set for LIST and PUNCH. The relationshio between ESW settings and 
remote batch disposition codes is explained in the Remote Batch 
Facility User's Guide . __ 




INVOKING THE RST TASK GPOUR 


To invoke the RST task group and associate it with a logical stream, 
enter the following command, 

RBF lrn(C/R) 
or 

^ZSYSI I RBF lrnCC/R) 
or 

RUT device_na:ne 

The irn value or device_name is taken from the configuration 
directive in the CLM_JSHR file. It specifies the logical stream you 
wisn to use. 

*i"ne system responds with* 

< t g) hhmm RBF xnnn mm/dd/hhmm AA/BB/CC/DDOD 
(td) hhmm RBr ROY 
C t g > hhmm RBr STATION NAME - 99 °9 


(Cartridge disk environment) 
(Diskette environment) 


tg - Task group id. 
hhmm - Hours, minutes 

x - S for SAr mode, L for LAF mode 
nnn - Software revision number 
AA/33/CC/DDD0 - Data/Time identification of R3F 
9999 - NFS Station Name for LHDLC only. 

The system is now ready to accept commands. 


initializtm with a Command File 


\a alternate method of performing initialization is to build a 
command file with the system Editor and use the EC command for 
execution. The following steps are necessary* 

I. Refer to the System Messages manual for a descriDtion of the 
Execution Command (EC) and the EC command arauments, and to 
the Program Preparation manual for instructions on the use of 
the THItorT T 

An example of a command file to soawn a task group is* 

5 SP_GRP.EC 1980/06/08 


AN 


SG A I RBT. USER.OPR 2 !C()NSOLE -OUT ICoNSoLE 
-ND RBT_DlR -POOL AB 
$Q 

To execute this command, you must be operating in the system 
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task group ($S) and type in* 

EC SP_GRP(C/R) 

The system responds with* 

($S)SG AI RBT.USER.O/R ... 

<$$>RDY* 

You can now either remain in the system default task group or 
change to a new task group by typing* 

C IA1 KC/R) 

Again, it is advisable to turn ready on by typing* 

RDM(C/R) 

The task group resoonds with* 

(A I)RDY* 

2. The second command file, as stated above, oerforms the ASSOC 
and MSrf commands and invokes the RBT. An example of this 
command file is* 

4 RBT.EC 1960/06/08 


4N 

ASSOC 1 -IC0R00 
ASSOC 2 ! LPTOO 
ASSOC 3 PUWCHjFILE 

MSN -ALL OFF -ON 01 (Optional! defines default state) 

R3T 03 (Cartridge disk! specify *ZSYSJI RBT 03 for diskette) 
40 

The tyoein for this file is* 

EC RBTCC/R) 

The system responds by printing out the commands in the 
command file, and* 

(tg) hhmm RBT xnnn nm/dd/hhmm 
(tq) hhmm RBT RDY 

You are now ready to oerform remote batch processing. 

3. If the system is to have multiole terminals, individual 

command files can be generated for the task groups and they 
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can be grouped into a single command flie. 

example * 

A SP_JRP5.EC 

EC SP.JRPI 
EC SP_JRP2 
EC SP_GRP3 
$Q 

3y typing In* 

EC SP_JRPSf C/R) 

you can spawn three task groups with a single command, or, if 
desired, you can spawn the task grouos individually. 
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APPENDIX 0 
FILE TRANSMISSION 


This aopendix described the Mini 6 configuration particulars that 
relate to file transmission in conjunction with the configuration 
Information already presented in this manual. In this appendix, 
"TRAN** is a general term used to denote the various Mini 6 file 
transmission utility designations (TRAN and TRAN8). 


LINE PROTOCOL CONFIGURATION 


Ihe VIP 7700 line orotocoi is utilized in file transmission between 
the Mini 6 and Cl I HONEYWELL BULL host systems. Through the use of 
the PVE (oolled VIP Emulator) line protocol handier, the Mini 6 
aooears to the host system as a VIP 7700 terminal. Ihe PVE Is 
configured using the PVE directive as described in Section VI of 
this manual. 

The following argument soecifications of the PVE directive must be 
noted in configuring a Mini 6 for file transmission* 

. The poll address soecified in the directive must match that 
configured in the host system for the desired communications 
line. 

. High-speed lines should be configured at the highest priority 
levels (lowest numeric)* i.e., line speeds of 2400 and 9600 
baud could be configured -at priority levels of 20 and 10, 
respectively, but not 10 and 20. The maximum line speed 
suooorted in the file transmission facility is 9600 baud, 

. The disk device containing the files to be transmitted or 
received must be configured at a lower oriority level (higher 
numeric) than the communications device. 

. The lrn selected for the directive is the argument used in the 
TRAN invocation for file transmission (see the aopropriate File 
Transmission manual). If a DEVICE directive is coupled with a 
PVE directive, a filename may be used in the TRAN invocation as 
an alternative to a numeric lrn. 

In a Mini 5 to Mini 6 file transmission configuration, the Mini 6 
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designated as the host system (acceptor) is configured with a VIP 
(see Section VI) for the communications line, while the Mini A 
acting as the remote station (initiator) is configured with a PVE 
for the same line. Again, the poll addresses must match, 

NOTH* If nonswitched lines are used in Mini A to Mini A file 

transmission, the system configured with a PVE must have TRAN 
invoked first, Tis will Insure that polls sent from the host 
system will be answered. 


Mini 6/3SC 2780 File Transmission 


The Mini 6 configures SSC protocol on the desired communications 
line for file transmission with an IBM system. The BSC directive 
must specify EBCDIC (see Section VI, *'BSC Directive**) • The same 
argument soecifications listed above apply. 


MEMORf SIZE 


The memory retirements of the TRAN program, as detailed in the 
aopropriate Pile Transmission manual, must be included to calculate 
the size of the system poll area as described in this manual* This 
is done to meet the requirement of shareable bound units. 

The memory pool associated with the task grouo(s) in which TRAN will 
be initiated must meet the size requirements of task group control, 
lead task control block, EC1 task, plus the additional work soaces 
as detailed in the appropriate File Transmission manual. 

NOTE* A task group must be created for each concurrent execution of 
TRAN. The available memory for each greuo must, again, meet 
the size requirements as stated above. 
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2780/3780 WORKSTATION FACILITY CONFIGURATION 


For the 2780/3780 Workstation Facility <NF) to interface effectively 
with the host system* the following Mini 6 configuration environment 
must oe established* 

. Noncommunication directives to define the following 
noncommunications aspects of the system software* 

- System variables 

- Characteristics and sizes of memory pools 

- Physical and logical characteristics of peripheral devices 
used by the 2780/3730 WF. 

- System overlays 

- System software extensions 

. Two communications directives used to define the following* 

- The oriority level at which the MLCP (Multiline 
Communications Processor) interrupts the central Drocessor 
(COMM communications directive) 

- The binary synchronous line protocol handler (BSC 
communications directive). 

- Jse (or non-use) of mu 11i-record feature. 

Usa'je of both communications and noncommunications directives are 
described in details in this manual. 

Figure H-i shows a typical Mini 6 configuration required to execute 
the 2/30 WF. 


( I ) 

I0R 2780 WF, the multi-block-count must be either 2 or 7 to match 
the host configuration. 
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(SH)DEVrCE K SR 00,0,5, X ' 005 O' , CON SOLE, 

(SH)SYS ,,,10,40,40,,E 
(Sd)DEVICE RCDOJ,4,9,X'l480' 

< $H)DEVICE LPT00,5,18,X'!380',LPTO0 
(#d)DEV ICE CDR00,6,J 9,X'1300',CRDOO 
($d>DEVICE DSKO0,7,l2,X'4OO' 

(Sd)DEVICE DSKOI,8,13,X'480' 

(SH)DEVICE DSK02,9,I4,X'1200' 

( $H)DEVICE D SK03, I 0,15, X 1 / 1280 

( $H)COMM20 

($H)BSC 22,22,X'FCOO',2,P,E8,7 Communications Directives 

(Sd)MEMPOOL S,, 10000 

<$d)MEMP(X>L ,AB,* Noncommunications Directives 

(Sd)* 

(SH)QUIT 


140 

Noncommunications 

Directive 


Figure H~l. Typical Mini 6 Configuration to Execute the 2780 WF 
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APPENDIX J 


HASP WORKSTATION FACILITY CONFIGURATION 


For the HASP Workstation Facility (WF) to effectively interface with 
the nost system, the following Mini 6 environment must be 
estabiished * 

, Noncommunications directives to define the following 

noncommunications aspects of the system software* 

- System variables 

- Charactertistics and sizes of memory pools 

- Physical and loiicaL characteristics of pheripheral devices 
used by the HASP WF 

- System software extensions 

» Two communications directives used to define the following* 

- The priority level at which the MLCP (Multiline 
Communications Processor) interrupts the central processor 
(COMM communications directive). 

- Tne HASP line orotocol handler (HASP communications 
direc ti ve) 

Figure J-1 shows a tyolcai Mini 5 configuration reautred to execute 
the IA3P WF. In this example, the Host Link oarameter (-N) could be 
any one of the following* -N 33, -N [HASP!, or -N>SPD>HASPt. 


SYS ,,,)J,20,20,£ 

DEVICE fCSRTO^o.X'OSOO' ,CONSOLE,UO 
DEVICE RCDOI,4,9,X'1480 y 

DEVICE RCJ02,5,I0,X'1500' 

DEVICE ECD03,6,II,X y 1580' 

DEVICE FCDOI,3,9,X'I 480' 

DEVICE FCD02,9,10,X 7 1500' 

DEVICE F0D03,10,I I,X'1580' 

DEVICE <3R0I,1l,I 2»X'G530',TTY0t Noncommunications 

Directives 



DEVICE DSKOO,12,J3»X'04D0 y 
DEVICE DSKOl,13,14,X^0480^ 

DEVICE DS<02,14,15,X'120CH 

DEVICE DSJC03,15,16,X' 1280' 

DEVICE MT900,16,17,X'1600' 

DEVICE LPTOO, S 7,181300^«LPTOO 

DEVICE CDR00,18,191300^,DCROO 

CDMM 25 

MAS? 33,34,X'FC0O' 

DEVICE HASP, 33,34,X'FC0CK,HASPl 

M5MP(X)L S f , 10000 

M£MP(X)L ,AB, * 

QUIT 


Communications 

Directives 


Noncommunications 

Directives 


Figure Typical Mini 5 Configuration to Execute the HASP Hf 




APPENDIX K 

PROGRAMMABLE FACILITY/3271 


NOTE* See the 3270 Interactive Fact 11ty User^s Guide for 

Programmable haci(PF/3271) operating instructions. 

After an initial system startup, invoice the Editor to build* (I) a 
CLM_USER file used in configuration of the system software that 
suoports the PF/3271 and (2) a login terminals file used to describe 
the characteristics of each VIP 7200 terminal used in the dynamic 
login of VIP 7200 terminals. A CII HONEYWELL BULL supplied 
generation orogram (ZF32IN) must then be invoiced to build an 
intialization file. If COBOL oroaramming extensions are used in 
conjunction with PF/3271, the COBOL program must be linked to a 
special interface routine (TCOBIF). The details of the 
initialization file, CLMOUSES file, login terminals file, and COBOL 
interface are described in this Anpendix • 


CLM.JSaR FILE, 


The CLM_J$ER file is used to configure GCOS to support the PF/3271. 
The Pr/3271 is comoosed of the following two bound units* (I) one 
defining the line protocol handler (LPH) for the host system and (2) 
one to define the apolication oortion of the ?F. The line protocol 
handler must be loaded at stage 2 system startuo (see "Staqe 2 
Systen Startup (Intermadiate System Startuo)", Section til). The 
directive that defines (loads) the line orotocol handler for the 
host system is described in Section V of this manual (see H3270 
Directive). 

Configuration information identifying VIP 7200 terminals, on lines 
serviced by the Asynchronous Terminal Driver (ATD), is supplied 
through use of ATD directives (See Section V of this manual). When 
the system is rebooted, at stage 2 system startuo from the CLM_USER 
file, a communications line is configured for each ATD terminal 
display olus one communications line for the host system. 


CLM_U3ER FILE EXAMPLE 


The following is a tyoical example of a CLM_USER file used in the 
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generation of the PF/3271* 

CLAUSES FILE 

DEVICE KSROO,5,X'0600','CONSOLE',140 
SYS 60,50,,2,20,60,5,E 
DEVICE LPT00,30,)0,X'0680' 

COMM 7 

DEVICE ATDOO,13,9,X'rFSO',VIPOO,80,N 
DEVICE A TOOI f I4,9,X'FE8Q',VIP0I,80,N 
DEVICE ATD02,15,9,X'FF00',VIP02,80,N 
DEVICE AT003,J6,9,X'FE00',VIP03,80,N 
DEVICE 35C0Q,)2,8,X'FCOO' ,BSCOO 
DEVICE 85001,12,8,X'FC80',BSC01 
ATDOO I 3,9,X'rFSO',0,9600,'7200' 

ATDOI l4,9,X'Fr00',0,9600,'7200' 

ATJ02 I5,9,X'FE00' ,0,9600,'7200' 

ATJ03 16,9,X'FEOO',0,9600,'7200' 

HJ270 ^a.X'FCOO'^X^CK.X'dO' 

H3270 11,8,X'FC30',2,X'40',X'60' 

MiMrhJOL 5,,I 7000 
M£viP;)OL ,A3,* 

MEMPCXJL , AC, * 

MEMprx)L ,L0,* 

ME .(POOL ,L I ,★ 

McM?(X)L ,L2* 

MEMPOOL ,L3* 

Q’JIT 

In this example of a CLMAUSER FILE, the following is shown* 

• Four ATDnn directives have been used causing four 
communications lines to be configured, one oer VIP 7200 
terminal• 

, A DEVICE directive has been “provided" with each ATDOO 

directive so that each pair contains the same Irn, level, and 
channel number, 

NOTE* See “DEVICE Directive”, in Section 5 of this manual, 

, Two H3270 directies have been used indicating that the line 
protocol handler tlph) will be loaded once defining two host 
system links, 

• A DEVICE directive has been “paired” with each H3270 directive 
so that each oair contains the same Irn, level, and channel 
number. 

NOTE* See “DEVICE Directive”, Section V of this manual* 


LOGIN TERMINALS FILE 


The login terminals file is used to describe the characterises of 
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aacn VIS 7200 terminal to be monitored by the listener (a system 
software comoonent) for access requests issued by the PF/3271. The 
file is created with the Editor and consists of* (1) variable-length 
j» t r- and A-tyoe records and, ootionally* (2) a LOGIN cormand. 

The following is an example of building a login terminals file. 


Examg le * 


Building the login terminals file (after initial system startup). 


Entries 

ditor Commands And 
Irectives * 

EC 

A 


Login Record Entries* 


G 1 3 
T VIPOO 
A A 
A d 
A C 


editor Command And 


directives 


!r 


P 


.1 TE3MI 


JUIT 


Comments 


Command to load the Editor 

Append directive used to enter 
login records (comorislng the 
terminals file) into the current 
buffer 


J-, T- and A-tyoe records comprise 
this example of the login terminals 
file to be named "TERMl". In this 
example, only VIPOO will have access 
to host system links 8SC01, BSC02 and 
B3C03. The host system links will be 
estabiished through issuance of three 
separate login commands from the 
operator's conso le, 


Editor escaoe character 

Print directive used to disDlay 
contents of the current buffer. 


rfrite directive used to write 
contents of the current buffer to 
the login term!nais file named 
TERM I 


Causes the Editor to cease reading 
commands and directives. 


The following example shows three oossible login terminal files 
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incorporating login commands 


example * 

I, Building the login terminals ftle (after initia1 system 
startup). 


Entries 

Editor Commands And 
Direct!ves 
ED 

A 


Login Record Entries 


G 2 I 

T VIPOO L HOST1 AA 
-ARC !SSCOI Cl 


G 2 3 
T VIPOO 

A A L HOST! -AA 
-ARG !SSCOI Cf 
A 3 L H0ST2 A3 
-Arid !BSC02 C2 
ACL HOST3 AC 


G 2 4 

A A L HOSTI AA 
-ARu !B5C0I C) 
A 3 L HOST2 AB 
~ARu !BSC02 02 
ACL HOST3 AC 
-ARC IBSC02 C3 
T VI POO 
T VIPOI 
T VIP02 
T VIP03 


Comments 


Command to load the Editor 

Aopend directive used to enter 
login records (comprising the 
terminals file) Into the current 
buffer 


Possibility #1 


G— and T-type record entries comorise 
this examole of a login terminals 
file. In this example* only VIPOO 
has access to host link BSCOJ. 

Possibility #2 

G™, T- and A-type records comprise 
this example of a login terminals 
file. In this example* only VIPOO 
has access to host links BSCOI* BSC02 
and BSC03 because the T-record ore- 
c edes the A-records. 

Note* If multiple T-records precede 
the A-records, only the last 
entered T-record is recognlzed. 

Possibility #3 

G~, Ap and T-tyoe records comorise 
this examole of a login terminals 
file. In this example* all VIPs 
have access to host links SSCOI, 

BSC02 and 3SC03 because the T- 
records follow the A-records. 


I 
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Editor Commands And 


Cl rectives 


!F 


P 

W TERM I 


3UIT 


Editor escaoe character 

Print directive used to disolay 
contents of the current buffer 

Write directive is used to write 
the contents of the current buffer 
(for one of the previous three 
possibilities) to a login terminals 
file named TERM!. 

QUIT directive causes the Editor to 
cease reading directives. 


INITIALIZATION FILE 


The initialization file is used to define the site-specific 
information used to interface with the PF/3271. A CII HONEYWELL BULL 
suoolied generation program, ZF32IN, is provided to perform the 
following* 

. Create the initialization file 

. Update an existing initialization file' 

. List (partially or totally) an existing initialization file on 
the operators console. 

The generation program operates in an interactive mode consisting of 
alteraatina questions and resoonses between the generation orogram 
and you. Depending on the site-specific information to be included 
in the initialization file, two levels of functionality are provided 
by the generation program. 


Level I runctjona11ty 


At this level, the generation Drogram allows the following 
initialization file/record manioulation* 

. Inclusion of records defining host system linkages (throuah use 
of the HOST directive, described later In this appendix). 

. deletion of existing host system records and affiliated device 
assignment records (through use of the DELETE directive, 
described later in this aopendix). 
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. Positioning of the initialization file to either receive new 
device assignment records or uodate existing device assignment 
records affiliated with host system records (through use of the 
POSITION directive* described later in this appendix)* 

. Listing, on the operator's console, of all information 
pertaining to either* (!) all records defiuinq host system 
linkages or (2) a specific record defining a host system 
linkage (in both cases, through use of the CURRENT directive, 
described later In this aopendix). 

. Soecification of the number of Screen Image Buffers (through 
the BUFFERS directives, described later in this appendix)* 

directives, which interface with the generation orogram in the 
interactive mode, are used to imolement the orevlously described 
initialization file/record manipulation. Table K-J shows the level 1 
directives which are used to define host system linkages* 


Level 2 Functionality 


At this level, the generation program allows the following 
initialization file/record manlouiation * 

. Definition of device (address) assignment records (through use 
of the PRINTER, VIRTUAL and SCREEN directives). 

. Uodating ,or deletion of device (address) assignment records 
(through use of the Y, N and D directives). 

Directives, which interface with the generation program in the 
interactive mode, are used to implement the orevlously described 
initialization file/record manlouiation. Table K-2 shows the Level 2 
directives which are used to define or update device (address) 
assignment records, depending on the desired aooiication, both Level 
I and Level 2 directives can be used together. 

In the format descriptions shown in the tables which follow, 
brackets (t )) enclose optional arguments and braces (( >) indicate 
a choice. 



Table K-l. Level I Directives 










* Table (C-l (Cont). Level t Directives 



Level 1 Directives/Responses 


CURRENT [pathname] 

If pathname is specified* all 
information pertaining to a 
specific record (defined through 
a HOST directive) identifying a 
host system linkage is listed. 

If no pathname is specified, all 
information pertaining to all 
records (defined through several 
HOST directives) identifying sev¬ 
eral host system linkages is 
listed. 

oathname consists of !xxxx 
where xxxx reoresents a communica¬ 
tions device_unlt (see "DEVICE 
Directive," Section V of this 
manual). 

BUFFERS nn 

Enter Indicates the number of 
Screen Image Buffers (SIBs), 

nn consists of values from I to 
99. If the number of SIBs have 
been previously specified, entry 
of nn overlays any previous 
number. 

NOTE * 'COPY' minimally requires 
two buffers. The number 
of buffers should eaual 
one-half the number of 
screens. 

NOTE t The promot ENTER CURRENT OR 
HOST rtITH PATHNAME, BUFFER 
OR QUIT again appears 
following the 3UFFERS 
entry. 

QUIT 

Entry indicates the initialization 
file will be closed and generation 
orogram ZF32In will be exited. 
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Table K-2. Level 2 Directives 










Table K-2 (Cont). Level 2 Directives 



Level 2 DirectIves/Resoonses 


NOTE* Update and delete functions 
are described later in this 
table. 

pathname consists of the pathname 
of the application proqram accessino 
the virtual device. For a description 
of oathnames, see the appropriate 
Operator's Cuide. 

SCREEN dn (pathname 1 C19203 

Entry indicates a VIP 7200 terminal 
display unit. 

dn consists of a valid device 
address selected from Table JC-4. 
later In this appendix. If the 
device (address) assionment record 
(affiliated with the particular 
host system record) has not been 
previously defined, a new device 
(address) assignment record will be 
created. However, If the device 
(address) assignment record has 
been previously created, you must 
either uodate or delete the device 
(address) assignment record. 

NOTE* Jpdate and delete functions 
are described later in this 
table. 

Optional* pathname is the oathname 
of the user's aoolication oroaram. 

NOTE* Level I directives HOST, 

CURRENT or SUFFERS can be 
entered following the oromot* 
ENTER COMMAND OR QUIT. However, 
the effect will be to terminate 
any other entries, uodate any 
device (address) assignment 
records and return to Level I 
processing (see Table K-l, 
earlier in this anoendix). 
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Table K—2 (Cont). Level 2 Directives 










error Messages 


The following error messages, shown In Table K-3. are produced by 
the generation program. 


Table rC—3* Error Messages 


e 


rror Messages 


DescriDtion 


ILLEGAL PATHNAME 


The pathname used on a OUTWENT directive 
could not be located. The following 


generation program oromot is reoeated* 
ENTER CURRENT HR HOST *ITH PATHNAME. 
BUFFER OR QUIT. 


PATHNAME MISSING 


INVALID DEVICE* 
COMMAND IGNORED 


INVALID PARAM 


Either* 

(1) A HOST directive without a 
pathname was entered. The 
following generation program 
oromot is reoeated* ENTER 
CURRENT OR HOST NITH 
PATHNAME, 3UFFER OR SUIT. 

or* 

(2) A PRINTER or VIRTUAL directive 
without a pathname was entered. 

The following generation program 
oromot is reoeated* ENTER COMMAND 
OR QUIT. 

PRINTER. VIRTUAL or SCREEN directive does 
not have oroper device (address) assignment 
(see Table K-4 for proper device addresses). 
The following generation program oromot is 
repeated* ENTER COMMAND OR QUIT. 

For the BUFFER directive, nn exceeds two 
digits. The following generation orogram 
oromot is reoeated* ENTER CURRENT OR HOST 
NITH PATHNAME, BUFFER OR QUIT. 


For the HOST directive, nnnn (blocJc-size) 
exceeds four digits. The following generation 
program prompt Is reoeated* ENTER CURRENT OR 
HOST rfITH PATHNAME, SUFFER OR QUIT. 


NO HOSTS CREATED 


Before any host system records were created, 
a CURRENT directive was specified without, 
in this case, a required pa th na me. The 
following generation orooratn oromot is 
repeated* ENTER CURRENT OR HOST NITH 
PATHNAME, BUFFER OR QUIT. 






Table K*»3 (Cont). Error Messages 



Device Add resse s 

m-n M MW I BH I 

The following table shows the valid addresses used with the VIRTUAL* 
SCREEN and PRINTER directives (shown In Table K-2). 

Table K-4, Device Addresses 
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Table K-4 (Cont). Device Addresses 


Device or 

Control Unit 
Numbers 

Addresses 

23 

D7 

24 

D8 

25 

09 

26 

5A 

27 

5B 

28 

5C 

29 

5D 

10 

5E 

31 

5F 


Examples of Initialization riles 


In Example I, an initialization file has been created containing one 
host system record and its associated device (address) assignment 
records * 


Example \ * 

ROY * 

ZF32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTER CURRENT FILENAME 

TESTFL 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
BUFFERS 06 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST J BSC I 

ENTER COMMAND OR QUIT 
PRINTER Cl ILPT01 
ENTER COMMAND OR QUIT 
PRINTER C2 !LPT02 
ENTER COMMAND OR QUIT 
SCREEN 01, PROG I 
ENTER COMMAND OR QUIT 
SCRFEN D2, PROG! 

ENTER COMMAND OR QUIT 
SCREEN D3, PROG I 
ENTER COMMAND OR QUIT 
VIRTUAL 5A >D0NW>PR0GI 
ENTER COMMAND OR QUIT 
CURRENT 

CURRENT DEVICE ASSIGNMENTS* 

BUFFER COUNT 06 
NUMBER OF HOSTS 01 
HOST LINK !BSC) 
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Example f (Cont)* 


BLOCKING 0512 
SCREEN 01 1920 PROG1 
SCREEN D2 1920 PROGI 
SCREEN D3 1920 PROGI 
VIRTUAL 5A >DONW»PROGl 
PRINTER Cl !LPT01 
PRINTER 02 JLPT02 

ENIER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
QUIT 


In Example 2, an Initialization file has been created containing two 
host system records and their associated device (address) assignment 
records * 


Example 2« 

ROY* 

2F32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTER CURRENT FILENAME 

TESTF1 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

HOST !BSC 1 256 

ENTER COMMAND OR QUIT 

PRINTER Cl ILPT01 

ENTER COMMAND OR QUIT 

PRINTER C2 !LPTQ2 

ENTER COMMAND OR QUIT 

SCREEN Dl, PROGI 

ENTER COMMAND OR QUIT 

SCREEN 02, PROGI 

ENTER COMMAND OR QUIT 

SCREEN U3, PROGl 

ENTER COMMAND OR QUIT 

VIRTUAL 5A >DONW>PROGl 

ENTER COMMAND OR QUIT 

BUFFERS 09 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

HOST 18SC2 1024 

ENTER COMMAND OR QUIT 

PRINTER C3 !LP703 

ENTER COMMAND OR QUIT 

PRINTER C4 !LPT04 

ENTER COMMAND OR QUIT 

SCREEN,04,! TTY04 

ENTER COMMAND OR QUIT 

VIRTUAL 5r >DOWN>PROG2 

ENTER COMMAND OR QUIT 

CURRENT 
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Example 2 (Cont)* 


CJRRENT DEVICE ASSIGNMENTS* 

BUFFER COUNT 09 . 

NUMBER OF HOST 02 

HOST LINK !BSC I 
BLOCKING 0256 
SCREEN 01 1920 PROGI 
SCREEN D2 1920 PROGI 
SCREEN D3 1920 PROGI 
VIRTUAL 5A >D()WN>PROGI 
PRINTER Cl ! LPTOI 
PRINTER C2 ILPT02 

HOST LINK 13SC2 
3L0CKING 1024 
SCREEN 04 1920 PROGI 
VIRTUAL 5F >D0HN>PR0G2 
PRINTER C3 ILPT03 
PRINTER 04 !LPT04 

ENTER CURRENT -OR HOST HITH PATHNAME* BUFFER OR QUIT 

QUIT 

RDY* 

In Example 3 f an initialization file (containing the host system 
records created in Example 2) Is positioned to the second host 
system record and updating and deletion functions are performed on 
existing device (address) assignment records* 

Example 3* 


RJY* 

ZF32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTER CURRENT FILENAME 

TH3TF1 

ENTER CJRRENT OR HOST WITH PATHNAME* BUFFER OR CUIT 
HOST !BSC2 

DO YOU WISH TO POSITION OR DELETE? 

POSITION 

ENTER COMMAND OR QUIT 
SCREEN * 5F *! TTY05,J 92 0 

UP J ATE OR DELETE EXISTING DEVICE ADDRESS?!YES,NO,DELETE) 
YES 

ENTER COMMAND OR QUIT 
PRINTER C4 1LPT04 

UPDATE OR DELETE EXISTING DEVICE ADDRESS?!YES,NO*DELETE> 
DELETE 

ENTER COMMAND OR QUIT 
CURRENT 

CURRENT DEVICE ASSIGNMENTS* 

BUFFER COUNT 09 
NUMBER Or HOSTS 02 
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Example 3 (Cont)» 


HOST LINK !BSCf 
BLOCKING 0256 
SCREEN 01 1920 PROG1 
SCREEN D2 1920 PROG) 

SCREEN 03 1920 PROG1 
VIRTUAL 5A »DONW>PROGI 
PRINTER Cl ILPT01 
PRINTER C2 ILPT02 

HOST LINK !BSC2 
BLOCKING 1024 
SCREEN 04 1920 PROG1 
SCREEN 5F- 1920 PROG! 

PRINTER C3 ILPT03 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

QUIT 

R2Y* 


COBOL Interface Program 


To run a COBOL program on the PF/3271, the COBOL orogram needs a 
special interface. The object module of the COBOL program must be 
linked with the CII HONEYWELL BULL supplied interface program 
(ZCOBIF). The-following is an example of creating such a bound unit 

LINKER XXXXXX 
• LIB >ZCIRT 

LINKN ZCOBIF, YYYYYYt MAP t QUIT 

where XXXXXX is the bound unit name assigned by the user and YYYYYY 
is the name of the COBOL program object file. 
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APPENDIX L 

LISTENER COMPONENT AND LOGIN CAPABILITY 


INSTALLING A SYSTEM LOGIN CAPABILITY 


The listener component enables access to the system from a 
designated set of terminals. It must run as the lead task of task 
group $L, and can be activated using commands In the system 
START_UP.EC file or by entering commands from the operator terminal 
after system startup Is comolete and the system is operational. 

rfhen the listener Is active, a user can Log In to the system from 
the noncommunications terminals (MDC-connected) or communications 
terminals <WLCiVDLCP—connected) listed In a "terminals M file. The 
terminals monitored by listener for a login command cannot be 
directly reserved by system applications. 

To provide a system with the login capability, make the following 
preparations* 

1* Create the terminals file which describes the login 

characteristics of each terminal to be used for login. This 
file determines In which one of three ways login Is to be 
achieved. A terminal can Ca) require a LOGIN command typein, 
(b) allow a user to t/pe an abbreviation for the login command 
line, or (c) be immediately logged in, without a type In, when 
it is ready or connected. 

2. Allocate- memory pools for login by use of the CL.M MEMPOOL 
directive. 

once these preparations are completed, you can activate the listener 
as the lead task group $L. Listener activation is described later In 
this appendix. 


MEMORY P(X)LS FOR LOGIN TASKS 


When you log in as a primary user at a terminal, a task group is 
spawned which has that terminal as its user_ln and user_out files, 
rthen you enter a LOGIN command, you may specify the task group 
Identification (a two-character group id) or accept a default group 
id. For each task group to be spawned by a login command, you must 
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define a memory pool whose oool_id is the same as the grouped. The 
first character of a default group.id/pool_id is an alphabetic 
character that may be specified by the user when the listener is 
activated. If no character is specified, the letter l becomes the 
first character* The second character is the next unused character 
from the sets and A,.„.,Z. If only defaults are taken, the 

number of default pools must at least equal the number of users who 
may concurrently gain access to the system. This number Is specified 
in the G-reeord of the terminals file. You can define pools that are 
completely overlapping by specifying each pool in a separate MEMP(X)L 
directive. (This also applies to any other type of memory pool that 
you wish to define). For example, to make available all of the 
nonexclusive pool area for the three users who accept default 
pool_lds, use the following directives* 

• MEMPOOL ,L0,* 

MEMPOOL ,LI,★ 

MEMP(X)L ,L2, * 

Additional examples illustrating the allocation of memory are 
included in the description of the MEMPrx>L directive. ^ 


TERMINALS FILE 


Listener determines which terminals to monitor for system access 
from information In a terminals file; The pathname of the terminals 
file may be specified in the command that requests the listener 
task, or may be defaulted to >SID>TERMINALS; The file is created 
with the Editor and consists of variable-length G-,T-, and A-type 
records. Arguments within a record are separated by one or more 
blank characters. For a terminal to have the direct login 
characteristic, the LOGIN command must be specified In the T-record 
for that terminal. 

For a terminal to have the option of accepting abbreviations for 
LOGIN commands it requires A~records with the desired command line 
image and the absence of a login line in the T-record for that 
terminal. One or more abbreviations can be soecifled; The A-records 
following a T-record are associated only with that terminal. The 
A-records following the G-records allow all terminals to use those 
abbreviations for command lines. When the same abbreviation is used 
In an A-record following a G-record, and In an A-record following a 
T-record, the command line Image in the A-record following the 
T-record is used for the terminal. The layout of the records of the 
terminals file is shown below. 
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G-Record (only one per file) 

EA-Records — one or more for all terminals) 
T-Record — for a specified terminal 
EA-Records — one or more for the above terminal) 
T-Record — for another specified terminal 
EA-Records — one or more for the above terminal) 


G-Record In Login File 


There is one G-record in the login terminals file, in the format * 

G base-ivl max_user 


base.lv1 

Level, relative to the lowest numeric (highest priority) level 
not used by the system group, on which the lead task of a group 
soawned by listener for a terminal is to execute unless a level 
is specified in the login line. 


max.user 

Maximum number of concurrent logged-in users allowed on the 
system. This value does not include task grouos created or 
spawned by commands other than LOGIN. Logins that exceed this 
limit are terminated and the listener Issues the message, 

3915 NUMBER Or CURRENT USERS EXCEEDS THE MAXIMUM 


T-record In Login File 


There is one T-record in the terminal login file for each terminal 
on which a user may log in, in the format* 

TEA) dev.name Elogin_llne) 


A 


Specifies that only abbreviated logins will be allowed at this 
terminal. If a user specifies a nonabbreviated login line at 
this terminal, the listener issues the following error message * 

39M * LOGIN MUST BE BY ABBREVIATION 
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dev.name 


Symbolic device name of the terminal* as specified at 
configuration. 

logiruline 

The login command line Image (including the LOGIN or L 
characters) used instead of a user type!n when a terminal is to 
be used for direct login.' 


A—Record In Login File 


An A-record contains an abbreviation character and the associated 
LOGIN command line image that the listener will use when a user 
types in the abbreviation. A variable number of A-records may follow 
the G—record and/or any THrecord. When a user enters an 
abbreviation* listener scans the A-records following the T-record 
for that terminal and if a match is found* uses that login line for 
logging in. If the abbreviation is not found, listener scans the 
A-records following the G-recerd for a match* and if a match is 
found* uses that login line for logging in. If no match is found* 
the listener Issues the message* 

39 OE ABBREVIATION FOR TERMINAL NOT FOUND 
The format for the A-record is* 

, A abbrev login_line 


a bbre v 

A l-character abbreviation that a user can optionally type in 
when logging in on this terminal. 

login.line 

The LOGIN command line image associated with the abbreviation. 
LOGIN COMMAND 


The abbreviated description of the LOGIN command that follows shows 
the type of entries that may be included in the A- and T-records of 
the terminals file. For a detailed description of the LOGIN command* 
see the Commands manual. Note that the length of the login command 
line Is limited to 110 characters. 

The LOGIN command causes ()) a task group associated with the user's 
terminal to be spawned* or* ( 2 ) the terminal to be attached to an 
existing task grouo as a secondary terminal. Once he has access to 
the system, the user cannot again invoke login unless he first uses 
the BYE command or the task group is otherwise terminated. 



FORMAT* 


L login.id Edestination_id3 £ctl.argl 


ARGUMENT DESCRIPTION* 
login_id 

Establishes the identity of the user who Is attempting to gain 
access to the system. Provides the user identification for the 
spawned task group* The login_id argument consists of from one to 
three fields having the following meanings* 

person 

person.account 
person.account.mode 
person 

Name of person who may access system* can be from t through 
12 characters. (For example, WDSMITH could be the value 
for the person field). 

account 

Name of an account under which the user is to work* can be 
from l through, 12 characters. (For examoie, JSINVENTORY 
could be used as the .value for the account field). 

mode 

Provides a further identification of the user* can be from 
1 through 3 characters. (For example, VER could be used as 
the value for this field). 

Cdestlnatlon_ld] 

optional argument that permits the user to log in as a secondary 
user of an existing task grouo. (A request for a secondary user 
terminal must have been oreviously issued by that task group). To 
log in as a secondary user of a user-created applications 
program, enter the value id, where id is the task group id of the 
task group in which the application is running. If this argument 
is specified, no other control arguments may be specified. 
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[ ctl_arg 3 


None or any number of the following control arguments can be 
selected * 


-P0 


* 

/path 


* f [level! 
id t 


Used to override the default lead task, group id/oool id, and 
relative level specifications for the task grouo spawned as a 
result of this login orocedure. 


path 


Pathname of the bound unit to be executed as the lead task of 
the spawned task group* If the star character (★) is entered 
the lead task Is the command processor* 


id 


GrouD_id/oool of the spawned task. The group_id and the 
pooi„id are represented by the same 2-character value. If 
this argument Is not specified, a default id is assigned as 
for memory pools. 

Default* The group id is a-2-character value whose first 

character was specified when the listener component 
was activated and whose second character is the next 
unused character in the sequence 0 through 9 and A 
through Z, assigned by the system. 

level 

Base priority level at which the spawned group is to execute 
(relative to the system group level). A base level of 0 is 
the next higher level. The sum of the highest system 
physical level plus l, and the base level of the group, and 
the relative level of a task within that group, must not 
exceed 62 (decimal). N 

Default* The base priority level Is that specified in the 

terminals file, relative to the system group level. 


-HD pa th 

Used to specify the home directory for the task grouo soawned 
as a result of the login procedure. The home directory is 
your initial working directory when you log in under an 
accoun t. 


path 

Pathname of the Initial working directory for the spawned 
task group. You must specify a full or relative pathname 
(not a simple pathname). If this argument is omitted, the 
working directory pathname is null. 
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LRN n 


used to override the default maximum logical resource number 
(LRN) value for the task group spawned as a result of this login 
procedure. 

* , 

n 

Maximum LRN value to be used for the spawned task grouo. (The 
maximum possible LRN value is 252). If this argument Is 
omitted, the maximum LRN value Is I. 


-LFN n 

Used to override the default logical file number (LFN) value for 
the task group spawned as a result of this login procedure. 

n 


Maximum LFN value to be used for the spawned task grouo. (The 
maximum possible LFN value is 255). If this argument Is 
omitted, the maximum value Is 15. 


HOLD 


Set the current connect/disconnect device-sDeciflc word to 
specify that the terminal is to be disconnected without phone 
hangup. This argument allows you to reuse the terminal without 
redialing after logging off the system. (See the set terminal 
characteristics (STTY) command or directive for information about 
the connect/disconnect device-specific word). 

Default* The terminal will be disconnected according to the 
setting of the current connect/disconnect 
device-speclfic word. 

-ARG arg arg ... arg 

Used to pass additional arguments to the lead task of the task 
group spawned as a result of this login procedure. 


LISTENER ACTIVATION 


Listener is activated with the CG (create group) and EGR (enter 
group request) operator commands, or with an SG (spawn group) 
operator command, using the arguments shown below. These commands 
and their arguments are described in the Commands manual. 

Once activated listener can be terminated only if the system shuts 
down, or by using the -GT argument of the SEX.LISTEN operator 
command. Once terminated, the $L task group can be recreated as 
described below. 
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CG SL base _lvl -EFN LISTENER -POLL id 


EGR SL user_id -OUT 'CONSOLE -ARG 


■OUT !CONSOLE - ARG 




■'’path 

/ 

"path 


-P CX)L 

id 

'path 


"path 

H 


CX3 £ "message**3 


EX3 £"message*3 



Pathname of the terminals file, which list the terminals on which 
users may log in, and which contains the terminal characteristics 
records. 

The last character in the pathname must be a blank and the entir j 
pathname must be enclosed in either single or double quotes. An ~ 
omitted (default) pathname must be written as a pair of 
enclosing single or double quotes (' ') or (" "), and results in 
the default pathname »SID>TERMINALS, 


Ex3 


The first character in the 2-character oool_id and grouo_id when 
default values are used. The second character, from 0 through 9 
or A through 2, is appended when a task group is spawned as a 
resuit of the LOGIN command. When this argument is omitted, its 
default value is L. 

When a user specifies a group_id In a LOGIN command or In a login 
line for a T-record or A-record, listener uses that as a group„id 
instead of generating a grouo_id. 

£"message"] 

The message-of-the-day, enclosed in quotes to provide for 
embedded blanks, which listener transmits to all terminals for 
disolay. 


Terminal State After Listener is Activated 


When first activated and again when the session terminates, listener 
performs specific operations affecting the state of a terminal; The 
output on the terminal that a user sees and the state of the 
terminal depend on whether it is a noncommunications or a 
communications terminal. 



NONCOMMUNICATIONS TERMINAL STATE WITH LISTENER ' 


If a terminal is not ready when listener is activated* no initial 
output messages from listener are displayed when the terminal comes 
on line* 

When listener is activated* 

t. If there are terminals online* ready for direct login* they 
display the message-of-the-day. A task group is spawned for 
each such terminal if the logln_llne image contained in that 
terminal's T-record in the terminal login file soecifies 
primary login. The lead task defined in the login line is 
executed* The aoollcatlon should display a prompter message to 
the terminal indicating that it is ready to accent inout. 

When the lead task terminates, the message-of-the-day is 
displayed and a task grouo is Immediately spawned again. 

If the login line in the terminal's T-record specifies 
secondary login, the terminal is given to the group named in 
the destination field* provided that the group has an 
outstanding request for a secondary terminal. The group 
returns the terminal to listener's control by executing a 
release terminal macro call. 

2. Terminals that require a user loqin, disolay the 

message-of-the-day and the user login oromoter message 
identifying the system and giving the date and time* 

LOGIN system id yyyy/mm/dd/ hhmmiss.t 

The user can then type in the LtXJIN command. When the lead 
task terminates, the message-of-the-day is displayed followed 
by the login oromoter message. 


COMMUNICATIONS TERMINAL STATE WITH LISTENER 


Although a communications terminal may not be ready when the 
listener is activated, listener displays a message when the terminal 
comes online. Otherwise* when listener is activated, the same 
operations are done for communications terminals as for 
noncommunications terminals described above. 

When a terminal is released* 

1. A terminal connected by phone and with the hangup option, is 
disconnected. The user must dial in again to use the terminal. 

2. A terminal connected through a modem bypass or by phone 
without the hangup option, displays the message-of-the-day* 
either the login promoter message is displayed or, for a 
direct login, a login task group is spawned. 
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CHANGING THE LOGIN MESSAGE OF THE DAY 


After listener is activated. It places an operator response request 
to tne operator terminal. The request number must be used in the 
response to listener from the operator terminal that changes the 
message-of-the-day. The message to the listener cannot exceed 63 
characters and is in the form* 

Amsg„no£ message-of-the-day 


EXAMPLES OF LISTENER OPERATION 


For these examples, the CLM file includes the following directives* 


DEVICE 

KSROI ,11,21 ,X'05SO'’,KSR0! 

DEVICE 

KSR02,12,22, X-'OdOO' ,KSR02 

MEMP(X)L 

S , , 1 0000 

McMP(X>l 

* LO f 'fr 

MEMP(X)L 

* 

4> 

MEMP(X)L 

, MI ,* 

MEMPOOL 

, A8,* 


Note that memory pools LO, LI, Ml, and AB all share the same memory. 


Example I * 

The terminals file for this example has the pathname ~ZSYS5I>TERM»T’ 
and contains the following records* 

G J 3 
T tCSROl 
A X L XXX 

A Y L Y.y[y’-PO * MI -HD ~ZSYS5I7SYSLIB2 -LRN 40 -LFN 20 
T JCSR02 
A rf L N.rt.N 

The listener is activated by command I made through the operator 
terminal* Commands 2,3, and 4 illustrate alternative logins made 
through terminal KSR01. Note that they cannot be executed in 
sequence unless each is terminated with a BYE command. 



Command I * 

ASS S3 $L A 10 -EFN LISTENER -P(K)L AS -OUT !CONSOLE 

-ARG '~ZSYS51.»TERM>T1A ' 


Command 2* 

AX 

Command 3* 

ait 

Command 4* 

AN 

The operations that result from each command are as follows* 

Command 1 * Spawns group $L with a user_id of A, a relative level 
of 10, bound unit of listener as the lead task, uses 
memory pool AS, the in„path and out_path Is the 
console and argument passed to listener is the 
location of the terminals file. The character used for 
default value of the first character of pool_id and 
grouped was not given and this defaults to L. 

Command 2* Listener spawns group L0 with a user_id of X.X.X., 

lead task of command processor. The command processor 
Issues the message* 170222 (No forking Directory) 
■because -HD option was not used. User may continue 
after typing in a CWD command. 

Command 3* Spawns group Ml with a working directoryy of 

‘“ZSYSSl »SYSLXB2 and the lead task is the command 
processor. 

Command 4* Because the A record Is under the T record for KSR02 
and not under the G record or the T record for fCSROl, 
the listener Issues the message. 

390E ABBREVIATION FOR TERMINAL NOT FOUND 

For a valid login, the rt must be typed in on KSR02. 
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Example 2* 

The terminals file for this example has the pathname *“ZSYS5I»TERM>T2 
and contains the following records* 

G t 3 

A Z L Z.Z.Z -PC) >SYSUB2>PR MI -HD ~ZSYS§ I >SYSLIB2 

-ARG »SUD>CLM_USER -SP I 

T KSROI 
T KSR02 

The listener is activated by command I made through the operator 
terminal* Command 2 is a login made through terminal KSROI. 

Command I * 

ASS 3G It B 10 -EFN LISTENER -P'XJL LO -OUT 'CONSOLE 

-ARG '~ZSYS5I>TERM>T2 4 ' 


Command 2* 

AZ 

The operations that result from each command are as follows* 

Command I * Spawns group SL with a user_id of 3, a relative level of 
10, bound unit of listener as the lead task* uses memory 
pool LOt the argument passed to listener is the location 
of the terminals file. The first chatacter of pool_id and 
group„id was not specified and defaults to L, 

Command 2* Spawns grouo Ml which prints CLM_USER and then 
terminates* 


Example 3* 

The terminals file for this example has the pathname ~ZSYS51>TERM>T3 
and contains the following records* 

G t 3 

T KSROI L A,A,A 

The listener Is activated by the following command which is made 
through the operator terminal. 

ASS SG SL C 10 -EFN LISTENER -POOL MI -OUT !CONSOLE 

-ARG '~ZSYS51>TERM>T3A' M 
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This is an example of direct login. The login command is specified 
in the T record. The spawn group command, typed on the operator 
terminal, spawns listener gi»up $L which uses memory pool Ml. 
Listener then spawns group Ml with the command processor as the lead 
task. Ml as its memory oool, and KSROI as user_in and user_out. 

The functionality of this soawn group command can also be achieved 
by the joint use of the create group and the enter grouo request 
commands as shown below. 

CO $L 10 -EFN LISTENER -POOL Ml 

EOR $L C -OUT !CONSOLE -ARG''~ZSYS51>TERM>T3A' M 

A message enclosed in quotation marks may be added to the entries 
following -ARGi This message will appear on the terminal when the 
group is activated. 
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APPENDIX M 


M4.SYSDEF CHECKLIST 


This aopendlx is included as a convenience for users of the 
M4_SYSDEF utility* You can use the checklist provided to write down 
information which the utility requires to generate your directive 
file. The information you write down on the checklist will be 
requested by the utility in the same order* 

Note that this checklist does not include all the questions which 
the utility asks* For examole, it doesn't list whether VIP devices 
support form feed. Also* the number of spaces orovided for writing 
information about peripheral devices isn't meant to imply any limits 
on how many devices of a given type you can include in your 
configuration. 



M4.SYSDEF CHECKLIST 


ITEM 


(Options/Units) 


1) Total amount of physical memory 

2) Default peripheral channel numbers? 
(If YES* ignore “Channel Number* 
entries for noncommunications 

devices) 


(nnnK) 

(YES/NO) 


3) Commercial system (Model 47/57)? 

4) (If NO to #3>* Simulator? 


(YES/NO) 

(YES/NO) 


5) Scientific processor? 

6) (If NO #5)* Simulator? 

7) System Identification message* 
(Default* “GCOS 6/MOD400*') 

8) Installation identifIcation* 
(default* “YOUR TOWN, USA*) 

9) Maximum number of concurrent users* 

iO) Default SPD names? 

(If YES, ignore "SPD name 1 ' column 
of subsequent entries) 

ID Record locking? 

12) Display rormattind and Control 
Software? 

13) Power fail restart? 

14) Communications devices? 

(If NO* skip items 15 through 21) 

15) Number of communications priority 
levels* 

16) Number of MLCPs * 


(YES/NO) 

(YES/NO) 


(YES/NO) 


(YES/NO) 

(YES/NO) 


(YES/NO) 

(YES/NO) 


(1 through 4) 


(1 through 10) 
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17) MLCP-connected asynchronous terminals* 

Comm, 

5P0 Channel priority Device 

name number level type 


18) VI? 7700's or VIP 7800's to be run in VIP 7700 emulation 
mode * 


Comm. 

Channel priority POP 

Number level type 


19) H3270 Host Links* 

Comm. Polling Select 
SPO Channel priority address address 
name number level (dec.) (dec.) 







20) tolled VIP Emulation Groups* 


Comm* 

SPD Channel Stations/ priority 

name number channel level 


Poll!ng 
add re ss 
1 2 


21) Synchronous Terminals* 


SPD Channel VIPs/ 

name number channel 


Comm. Control 

oriority Stations? POP 

level (YES/NO) type 


22) dinary synchronous communications lines* 


Comm. 

Channel priority 
# number level 


Primary/ 
secondary ? 
(P/S) 


I 


2 


4 


\ 
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23) MDC-connected console (terminal) devices* 


SPD Channel Device 

name number type 


<* CONSOLE 


24) Diskette devices* 

SPD Channel 
name number 


25) Cartridge disk devices* 

Fixed 

SPD Channel platter? 
name number (YES/NO) 


26) Cartridge module disk devices* 

SPD Channel 
name number 
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27) Storage module devices* 


SPD Channel 
name number 


28) Card reader devices* 

SPD Channel 
name number 


29) Card reader/punch or ounch devices 

SPD Channel 
name number 


30) Line printer devices* 

SPD Channel 
name number 
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31) Magnetic tape drives* 

SPD Channel 
name number 


32) Batch memory pool? (YES/NO) 

size of batch pool nnnnn or nnk 

words 

33) Number of 512-word system <1 to 10) 

overlay areas (1-99) 
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APPENDIX N 


ERROR LOGGING 


Error logging Is an optional feature that allows the system operator 
to collect memory or hardware-related error statistics for selected 
noncommunications peripheral devices. Error logging is intended 
primarily as a preventive maintenance tool, allowing for early 
detection and correction of potential memory or hardware failures. 
The error statistics collected can be used by CII HONEYWELL 3ULL 
field engineering personnel to monitor memory and peripheral device 
performance to determine if corrective actions are required. 

As the system builder, you have the option of configuring error 
logging or not(l). Once configured, the system operator must 
activate error logging through commands or macro calls. Error 
logging commands and operating procedures are described in the 
Command manual and the Operator's GuideJ error logging macro calls 
are described in the System Service Macro Calls manual. 


(I) 

The Interactive building program, M4„$Y$DEF, des not allow you to 
configure error logging. You must incorporate the aDpropriate 
software module by hand. 



COMF1 JURATION REQUIREMENTS 


Error logging must be incorporated into your configuration before 
memory or device error logging can be activated^ The following 
hardware and software requirements are necessary to configure error 
logging for your installation. 


Hardware Requirements 


Error logging requires that you have one or more noncommunications 
devices in your configuration that you wish to monitor. (If you wish 
to log memory errors exclusively* peripheral devices need not be 
attached to the central processor). In addition, cumulative file 
orocessing (described elsewhere in this appendix) requires that your 
installation has a CIP (or a CIP simulator). 


Software Requirements 


To implement error logging* you must load the bound unit ZERRST, 
located In directory SID, using an LD3U directive. If your working 
directory is SID, include the following directive in your CLM file* 

LDBU ZERRST 

Section V of this manual describes the LD3U directive in more 
detal1. 


MEMORY REQUIREMENTS 


The error logging facility requires a minimum memory area eauivalent- 
to the sum of the following components* 

. 254(16) words (SAP) or 26306) words (LAF) in the system memory 
pool for the bound unit ZERRST (of which 17(16) words, the 
initialization section, is overwritten after use). 

. 2206) words CSAF) or 23(16) words (LAF) in the system memory 
pool for each device that Is monitored. __ 

. 3906) words (SAF or LAF) in the system or user memory oooi for 
data for each error logging command. 

. Space for the bound unit to process a particular error logging 
command. 
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Error logging can be run in the system task grouo <$S) or in a user 
grouo (e.g., SH). Since the memory area necessary to run the error 
logging bound unit can be quite large, error logging should not be 
executed from the $S group. The operator should initially create a 
grouD large enough to accommodate the error logging session, (If the 
system operator wishes to create and maintain error loaging disk 
files, additional file space is required as well). 
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APPENDIX P 


CONFIGURING DISPLAY FORMATTING AND CONTROL SOFTWARE 


This aopendix describes the requirements for configuring the Disolay 
Formatting and Control software. Unless you configure this software 
for your installation, forms processing will not be available to 
users. If your Installation uses the Data Entry Facility-II 
<DEr-II)» you must configure Display Formatting and Control 
Software. Users should ha-ve available for reference the Display 
Formatting and Control manual. 


CONFIGURATION REQUIREMENTS 


The following hardware and software reauirements are necessary to 
configure the Display Formatting and Control Software. 


Hardware Requirements 


To performs forms processing, your installation requires one or more 
of the following asynchrnous terminals connected to an MDC or an 
MLCP/DLCP* VIP 7200, VIP 7205, VIP 7207, VIP 7301, or VIP 7302, and 
a full-duplex modem such as type 103, or one or more of the 
following synchronous terminals on MLCpt OKU 7007, OKU 7005. 


Software Requirements 


To configure forms processing, you must Include the approoriate 
directives in your CLM file as described below. 


CONFIGURATION DIRECTIVES 


The CLM directives required to configure the Display Formatting and 
Control Software depend on whether you wish to configure your 
terminals as nohcommunications (MDC-connected) terminals or 


I 
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communications (MLCP-eonnected) terminals* The directives mentioned 
below are fully described in Sections V and VI. 


Configuring Noncommunications Terminals for Forms Processing 


The CLM directives required to configure the Display Formatting and 
Control software with communications (MDC-connected) asynchronous 
terminals are as follows* 

VDAM 

This directive must be specified if the Display formatting and 
Control software is to be incorporated in the configuration* (See 
Section VI for a full descriotion of this directive). 

DEVICE CONnn,lr n,leve X.X'channe1', C de vice_name3, 

[record„sizeJ f HB H , ('7200' , (C l 

|(N fl )'D7200' \ T J 

For each asynchronous terminal capable of running Display 
Formatting Software, you must specify a DEVICE directive with the 
first oarameter as CONnn. The eighth parameter must be specified 
as either "7200» (for VIP 7200 or VIP 7205 suoport) or "D7200" 
(for VIP 7207 support). The ninth parameter must be specified as 
either C (for CRT visual display mode) or T (for teleprinter 
mode). The terminal runs in the mode you spec!fy whenever it is 
not running in forms mode (i.e., running tne forms processing 
software). .Forms mode overrides visual display mode or 
teleprinter mode. 


Configuring Communications Terminals for Forms Processing 


The CLM directives required to configure the Display Formatting and 
Control software with communications (MLCP-connected) asynchronous 
terminals are as follows* 


VDAM 

This directive must be specified if the Display Formatting and 
Control software is to be incorporated in the configuration. (See 
Section VI for a complete description of this directive). 

COMM n 


This directive is required for a system that includes 
communications. It must precede all other communica tions-re lated 
directives. See Section VI for a description of n, the number of 
interrupt priority levels. 
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LDBU 2QPACT 
LPHDEF 1,96,120 

LPHI lrn^evel^'channel^tmodemUspeed^DX.lDh-specific-word 

DEVICE '.ATDnn, lrn,level,X'channel-',tdevice - name ], 

(record_slzeJ , fJ B ll 

L« M «J - 


For each asynchronous terminal capable of running Forms 
Processing Software, you must specify an ATD directive and Its 
"paired* DEVICE directlve(1). The sixth parameter of the .ATD 
directive must be specified as either 7200 (for VIP 7200 or VIP 
7205 support), or F7200 (for VIP 7207 support). VIP terminals 
require a full duplex modem (such as type 103) to run forms 
processing. Additionally, the data rate (speed) in bits per 
second for any asynchronous terminal that will run forms 
processing should be l the range of 2400 to 9600. 

For use of the VDAM Blocte Mode terminal support, you must add 

LDBU 2MV77F 

and you must describe, through 

STDLN 
• STD 
POLIST 
, STAPOL 

The configuration of synchronous terminals to be used, the common 
device-type being V7760, both for DKU 7005 and OKU 7007. 


(I) 

Alternatively, you may specify a V7200 directive and its "paired 11 
DEVICE directive. However, CII HONEYWELL BULL recommands using the 
Asynchronous Terminal Device (.ATD) driver. * 
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CONFIGURATION OPTIONS 


In addition to the configuration retirements described above, you 
have two options to consider when configuring forms processing for 
your installation. You may choose to activate the listener 
capability for terminals Ln your configuration. You also have the 
option of configuring the operator terminal such that you can 
perform forms orocessing in a one-terminal configuration. 

Listener performs specific operations affecting the state of a 
terminal. Whether you wish to activate the listener or not depends 
entirely on your installation's processing reouirements. Refer to 
Apoendix L for a comolete description of the listener capability. 

The terminal configured as a standard operator terminal in your 
configuration does not suDoort forms processing. If, however, the 
operator terminal has been configured as a dual-ourpose terminal 
that runs alternately under operator control and user control, users 
can utilize the forms orocessing capability when the terminal is 
under user control (i.e., not functioning as an operator console). 

In this way it is possible to run forms processing in a one-terminal 
configuration. Refer to Section V for information on configuring a 
dual-purpose operator terminal. 
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APPENDIX R 

4 

ASYNCHRONOUS CHARACTER TERMINAL DRIVER (ACID) 


This appendix provides information necessary to configure a station 
on a line serviced by ACTD (asynchronous character terminal driver) 
through the Communication System, 


DIRECTIVES* 


The Asynchronous Character Terminal Driver must be loaded and 
initialized at CLM time when configuring terminals as DKU 7002 and 
its auxilary components, DKU 7001, VIP 7200, VIP 7100 or 
teletype-like devices, in the Communicatlons System, 

The configuration directives to be provided are* 

LD8U 

LPHDEF 

LPH1 

which are mandatory 
DEV ICE 

rthieh is to be provided only if the associated device is to be 
accessed thru File Management System, 

LDBU Directive 


The main part of the ACTD handler software (2QPACT) must be 
explicitly called by an LDBU directive, 

LDBU ZQPACT 

This directive may be put anywhere in the CLM file. It allows to 
load, residently, in memory the ACTD software. 
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LPHDtr directive 


The ACTD line protocoi handler makes use of two channel-tables 
and one station table for each serviced station* The sizes of 
tnese tables must be defined by an LPHDEF directive (involved by 
the further described LPHI directive) 


Format* 

LPHDEF 1,95,120 

Argument Description 

I value led by, the use of the further described directive LPH. 

95 channel-table size in words CLAF mode) 

120 Station-table size in words. 


Usage conditions 


There must be only one LPHDEF directive regardless of the number of 
serviced station. 

This directive must be below the COMM directive (defining the 
Communication System part of the CLM file) and must precide any LPHI 
directive. 


LPHI directive 

This directive allows to define a station serviced by ACT. 


Format * 

LPHI lrn,level,X'channel' / , [modem],speed, 

FDX,Xoh_speeific„word 

In this directive name LPHI, I is the reserved value which has 
been associated with the ACTD line orotocol handler. 


Argument Description* 

Irn 

'The logical resource number associated with the station. The value 
for Irn is an integer from 2 through 252. A program may use this 
number to identify the station when it requests an input/output 
operation to the station. 
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level 


The priority level at which the communications supervisor processes 
requests for an input/output operation to the station. The value for 
level is an integer from 7 through 58I it may be the same as the 
level specified for other communications stations, but it must be a 
higher number than the communications Interrupt level(s) specified 
in the comm directive* The level specified for one or more 
communications stations may not also be used for noncommunications 
devices or tasks. 

X v channel' 

A four-digit hexadecimal number (from X y 040n' to X y FF8n'}, 
specifying the channel number of the station and the interrupt 
priority level (n) of the line! The channel number has the following 
forma t * 

flits 0 through 9 - The 10-bit channel address of the send or 

receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

flits 14 and 15 - Specifies n, the priority level at which a 

communications line interrupts the central 
processor, n may have a value of 1,2, or 3 as 
soecifled in the COMM directive. See the 
description of the COMM directive for further 
Information. 

Cmodem] 

A number specifying the type of data set. Possible values are as 
follows * 

0 - Direct connect. 

1 - Bell lxx-type modem (103A, I13F, etc.)* Both data set-ready and 

carried-detect signals are needed for a connection* absence of 
both signals is a disconnection. 

2 - Bell 2xx-type modem (201A, 201X, 208A, etc.). The data-set-ready 

signal is needed for a connection* absence of this signal is a 
disconnection* 

3 or greater — User-defined modem type (see "MOOEM Directive 4 ', later 

in this section)♦ 

The default value is modem type 2. 

Sp eed 

The data rate In bits per second. The default value Is zero and 
signifies a synchronous line. 
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for an asynchronous line with a eommunlestions-pac whose id is 
2103(16), use one of the following values for speed * 


50 300 2400 

75 600 3600 

HO POO 4800 

134 1200 7200 

150 1300 9600 


for an asynchronous line with a communications-pac whose id is 
2100(16), 2110(16), or 2118(16), use one of the following values for 
speed. 


50 

200 

1800 

75 

300 

2000 

1 10 

600 

2400 

134 

1050 

4800 

150 

1200 

9600 


NOTE * If the data rate of the line is 134,5, specify 134. 


fDX 

Specifies that two channel tables will be assigned^ This parameter 
is mandatory. 


iph_speciflc„word 

A word containing information to be passed to the line protocol 
handier through the station table at offset 20SSTS. 

The structure of this word is 


l 

L 

L 

P 

S 


I 

I 


r 


D 

b 

D 

D 

D 

0 

' 1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

0 

£ 

F 


L These three bits indicate the presence of auxiliary units of 
the device. These bits will be ignored if the device type 
equals 0 or 1. 

. Bit 0 indicates the presence of a badge-reader 
. Bit 1 indicates the oresence of an auxiliary printer 
. Sit 2 MBZ 

P Bit of oarity specifies the parity to be used. 

0 * odd 
1 * even 
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S Stop bit-specifies the number of stoo bits that are to follow 
each character* 

0 ■ i stop bit will be used 

I * 2 stop bit will be used 

II DEVICE type-spedfies the type of terminal used 

0 * VIP7I00, teletype like device 

1 ■ VIP7200, OKU 7001 

3 * DKU 7002 

F rield-mode specifies whether the terminal will be allowed to be 
connected in field mode or not. 

0 = field mode allowed 

I * field mode not allowed 

D These five bits'specify the.number of DEL characters that are 
to follow LF characters in the pre-order ore-space or in the 
postorder control. . The value chosen may be I up to 32. 

NOTE* The support of the badge reader subsystem and the support of 

the printer subsystem are two parts of the ACTD software, each 
part is residently loaded only if the presence of the 
corresoondent subsystem has been indicated in one of the LPH! 
directives in the CLM file. 


Usage conditions 

There must be as many LPH directives as there are stations serviced 
by ACTD line protocol handier. 

All these directives must appear after the COMM directive and the 

LPHDEr directive to which they are associated. No others directives 

may be mixed with the set of LPHt directives. 

* 


DEVICE Directive 

This directive must be used if 

- either the driver is accessed by the file System in TTY mode. 

- or the device referenced is used like a "secondary* terminal. 
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Format» 


DEVICE devlce_unit*lrn,level ,X'channel'' ,de viee_name* 


trecord_size] 



Argument Description* 
device„unit \ 

A string of five ASCII characters! the first three roust be ATD and 
the last two characters (alphanumeric) Identify one specific station 
of that type. Must be in the format .ATDno. 

lrn*level and X'channel** 

are previously described 

device_name 

A string of I to 6 ASCII characters* the first of which must be 
alphabetic. This device„naroe is the unique File System name. 

Record_si2@ 

The length in bytes of one physical record <range) 

S/N ; 


File System definition of buffered/nonbuffered device. 
8 =■ buffered 


N » nonbuffered 


Usage conditions 


There must be a DEVICE directive each time a station is serviced by 
ACTD in TTY mode three the file system or each time a station Is to 
be logged as a "secondary" station. 

All the DEVICE DIRECTIVES IN A CLM file must appear after the set of 
related LFHt directives. 
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COMM 24 

LPHOEF 1,96,120 

* OK(J 7002 with a badge reader 

* (even parity, J stop bit, I DEL character) 

LPH1 16,26 ,X‘ / ICOO' ,0,9600,FDX,X'930I-' 

★OKU 700t 

* (even parity, t stop bit, 3 DEL characters) 

LPrt 17,2 7, X' IC80',0,9600,FDX,X'f103' 

* ROSY 24 

* (odd parity, 2 stop bits, 4 Dei characters) 
LPHI I3,28,X </ 1D00', 1,300,rDX,X'0844 / 

* YIP 7200 driven by AID line protocol handler 

A TO 19,29,X' 1D80',9600,'7200' 


DEVICE 

ATDOO, 

16, 

26, 

X'ICOO', 

VISU1, 

140, 

M 

DEVICE 

ATDOO, 

17, 

27, 

X'IC8CK, 

VISU2, 

140, 

H 

DEVICE 

ATDOO, 

18, 

28, 

X'IDOO', 

VISU3, 

140, 


DEVICE 

ATDOO, 

19, 

29, 

X / ID80 / , 

VISU4. 

140, 

N 


L03U ZQPACT 


I 


R—07 




INDEX 


2780/3780 WORKSTATION FACILITY CONFIGURATION, H-OI 
PROGRAM MATERIALS (SHC958) (FIG), 7-11 

TYPICAL MINI 6 CONFIGURATION TO EXECUTE THE 2780 WF (FIG), H-02 


2780 WF 

' TYPICAL MINI 6 CONFIGURATION TO EXECUTE THE 2780 WF (FIG), H-02 


^ZSYSSl 

TRANSFERRING CONTENTS OF -‘ZSYS51 OR^ZSYSdl TO FIXED PLATTER, 8-02 


‘“ZSY561 

TRANSFERRING CONTENTS OF ~ZSYS51 OR ZSYS61 TO FIXED PLATTER, 8-02 


A 


ACU 

ACU, 4-15 

ASSEMBLER/MACRO PREPROCESSOR 

ASSEMBLER/MACRO PREPROCESSOR PROGRAM MATERIALS (SHL937) (FIG) 7-08 
ACTD 

ACTD, 6—14 


ATD 

* ATT), 4-15 


8 


BASIC 

BASIC PROGRAM MATERIALS (SHL942) INTERPRETER. INTERPRETER/COMPILER 
(FIG), 7-13 

BASIC CLM DIRECTIVES, 5-01 

SUMMARY OF SASIC CLM DIRECTI VES'.(TBL) , 5-02 

BASIC CLM DIRECTIVES 
CLMIN, 5-18 
COMMENT, 5-20 
DEVICE, 5-21 ’ 


1-01 


I 



DRIVER, 5“26 
L03U, 5-29 
MAP, 5-32 
MEMP(X)L, 5-40 
QJIT, 5-59 
RESOLA, 5-61 
RLOCK, 5-62 
SYS, 5-65 
VARIABLE, 5-71 


BOOTSTRAP 

BOOTSTRAP OPTIONS CTBL), 3-16 
3fX)T$TRAP VOLUME 

SOFTWARE TO BE PLACED ON THE &OOTSTRAP VOLUME, 7-02 


BSC 

BSC, 6-22 


BUILDING, SYSTEM 

(SEE SYSTEM BUILDING) 


C 


CHANNEL NUMBERS 

ASSIGNING CHANNEL NUMBERS, 6-07 
DYNAMICALLY ASSIGNED CHANNEL NUMBERS, 6-08 
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FUNCTION OVERLAY LINKER DIRECTIVES (TBL), E-l3 

FUNCTION RES I DENT/OVERLAY ORGANIZATIONS (FIG), E-10 

GROUP GENERATION FOR A SYSTEM, E-26 

LINKING, E-05 

LINK INw FUNCTION OVERLAY OBJECT UNITS, £-13 
LINKING MEMORY RESIDENT FUNCTION OBJECT UN ITS, E-l2 
LINKING SYSTEM OBJECT UNITS, E-l2 
MEMORY CONSIDERATIONS, S-ll 
MEMORY FOOL DIRECTIVES, E-04 

MEMORY RESIDENT OBJECT JNIT LINKER DIRECTIVES (TBL), E-I 
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OBJECT UNITS (TBL), £-06 

OPERATOR STARTUP ACTIONS, E-34 

PRINTER ASSIGNMENTS, E-24 

PRINTER FORMATTING, E-l8 

RELATIVE LEVEL REQUIREMENTS, E-29 

RELATIVE PRIORITY LEVEL REQUIREMENTS (TSL), E-2<? 

RESIDENT AND OVERLAYED FUNCTIONS, E-09 

SAMPLE CLM-JSER FILE, E-02 

SAMPLE DISK ORGANIZATION OF SYSTEM AND USER FILES (FIG), 

sample linker directives file cfig>, e-34, e-35 

SAMPLE SPAWN GROUP EC FILE (FIG), E-34 
SAMPLE START-UP*EC FILE, E-30 
SAMPLE SYSTEM FILE STRUCTURE. E-31 
SAMPLE LINKER DIRECTIVE FILES, E-35 
SPECIFYING ALLOWABLE OPERATOR FUNCTIONS, E-24 


SPECIFYING 
SPECIFYING 
SPECIFYING 
SPECIFYING 
SPECIFYING 
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PASSWORD PARAMETERS, E-22 
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SYSTEM BOUND UNIT CREATION, E-11 
SYSTEM DEFINITION DIRECTIVE, S-05 
SYSTEM DIRECTORIES, E-05 

SYSTEM OBJECT UNIT LINKER DIRECTIVES (TBL), E-12 
TASK GROUP CONSIDERATIONS, E-26 
TTX DIRECTIVES, E-04 

DEF-I 

(SEE DATA ENTRY FACILITY-I) 

DEF-I 

OEF-II PROGRAM MATERIALS (SHC989) (FIG), 7-13 
DEVICE 

CLM DIRECTIVES AND SUPPORTED COMMUNICATIONS DEVICE* (TBL), 6-05 
DEVICE, 5-21, 6-27 
DEVICE ADDRESSES, K-»4 
DEVICE ADDRESSES (TBL), <-M 

DEVICE CONFIGURED IN FIGURE E-t OBJECT UNIT DIRECTORY PATHNAME 
(TBL), £-06 

DEVICE DIRECTIVE, E-03 

MAKING INITIAL DEVICE ASSIGNMENTS, F-05 

UNIT VALJES AND DEFAULT RECORD rOR VARIOUS DEVICE (TBL), 5-22 

DISPLAY FORMATTING AND CONTROL SOFTWARE 
CONFIGURATION DIRECTIVES, P-OI 
CONFIGURATION OPTIONS, P-04 
CONFIGURATION REQUIREMENTS, P-OI 
CONFIGURING, P-OI 

CONFIGURING COMMUNICATIONS TERMINALS FOR FORMS PROCESSING, P-02 
CONFIGURING NONCOMMUNICATIONS TERMINALS FOR FORMS PROCESSING, P-02 
HARDWARE REQUIREMENTS, P-OI 
SOFTWARE REQUIREMENTS, P-OI 

DRIVER 

DRIVER, 5-26 
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EDITOR 

USING THE EDITOR, 3-08 
EQLRN 

EQLRN. 6-35 


ERROR LOGGING 

CONFIGURATION, N-02 
HARDWARE REQUIREMENTS, N-02 
MEMORY REQUIREMENTS, N-02 
SOFTWARE REQUIREMENTS, N-02 

Error reporting 

CONFIGURATION LOAD MANAGER ERROR REPORTING, 3-17 
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EXECUTI VE 

M;£> 400 EXECUTIVE PROGRAM MATERIALS (FIG), 7-03 


EXTENSIONS, SYSTEM 

(SEE SYSTEM EXTENSIONS) 
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FILE 

A-RECORD IN LOGIN FILE, L-04 
CLM„USER FILE, K-CJ 
CLM„USER FILE EXAMPLE, K-OI 

CSD OPERATOR COMMANDS IN START-UP.EC FILE FOR SYSTEM TASK 
GROUP, 8-01 

DEr START.UP.EC FILE (TASK GENERATION), E-28 

FILE TRANSMISSION (Cl I HONEYWELL BULL HOST) PROGRAM MATERIALS 

(SHC95I) (FIG) , 7-10 

FILE TRANSMISSION (NON-CII HONEYWELL BULL HOST) (SHC953) (FIG), 7-09 

FORMULAS FOR CALCULATING FILE MEMORY SPACE (TBL) , 5-54 

G-RECORD IN LOGIN FILE, L-03 

INITIALIZATION FILE, K-05 

LOGIN TERMINALS FILE, K-02 

SAMPLE LINKER DIRECTIVE FILE (FIG), E-35, E-36 
SAMPLE SPAWN GROUP EC FILE (FIG), E-34 
SAMPLE STARTUP.EC FILE (FIG), .E-30 
SAMPLE SYSTEM FILE STRUCTURE, E-3I 

T-RECORD IN LOGIN FILE, L-03 . 

TERMINALS FILE, L-02 

FILE SYSTEM 

FILE SYSTEM PATHNAME IN CLM DIRECTIVES, 5-14 

FILE TRANSMISSION 

MINI 6/BSC 2780, G-02 

LINE PROTOCOL CONFIGURATION, G-01 

MEMORY SIZE, G-02 

FORTRAN 

ADVANCED FORTRAN PROGRAM MATERIALS <SHL9*4) (FIG), 7-12 
FORTRAN PROGRAM MATERIALS (SHL93M (FIG), 7-09 


FTr 

(SEE FILE TRANSMISSION) 
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H3270 

H3270, 6-39 


HARDWARE 

HARDWARE REQUIREMENTS, N-02, P-01 ’ - - 

SUPPORTED HARDWARE, C-03 
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SUPPORTED HARDWARE - MODEL 23 (TBL), C-03 


HASP 

HASP, 6-37 


HASP WORKSTATION FACILITY 

HASP WORKSTATION FACILITY CONFIGURATION, J-Ol 
HASP WORKSTATION FACILITY PROGRAM MATERIALS (SHC959) (FIG), 7 - 
TYPICAL MINI 6 CONFIGURATION TO EXECUTE THE HASP WORKSTATION 
FACILITY (FIG), J-02 
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LD8U 

LDS'J, 5-29 
U6U ZERRST, F-02 

LISTENER COMPONENT AND LOGIN CAPABILITY : 

A-RECORD IN LOGIN FILE, L-04 
CHANGING THE LOGIN MESSAGE OF THE DAY, L-IO 
COMMUNICATIONS TERMINAL STATE WITH LISTENER, L-09 
EXAMPLES OF LISTENER OPERATION, L-iO 
G-RECORD IN LOGIN FILE, L-03 
INSTALLING A SYSTEM LOGIN CAPABILITY, L-OI 
LISTENER ACTIVATION, L-07 
LOGIN COMMAND, L-04 
MEMORY P(X)LS FOR LOGIN TASKS, L-01 

NONCOMMUNICATIONS TERMINAL STATE WITH LISTENER, L-08 
T-RECORD IN LOGIN FILE, L-03 

TERMINAL STATE AFTER LISTENER IS ACTIVATED, L-08 
TERMINALS FILE, L-02 

LPHDEF 

LPHDEF, 6-45 
LPHN 

LPHN, 6-41 
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M4_SY SDEr 

EXAMPLES OF M4_$YS0EF USAGE, 4-32 
INVOKING M4_SYSDEF, 4-06 
M4_SYSDEF CHECKLIST, M-Ot 
M4.SYSDEF OPERATING CONSIDERATIONS, 4-02 
• USING M4_SYSDEF, 4-01 

USING M4_SYS0EF IN REBUILD MODE (FIG), 4-47 
USING M4_SY$DEF (FIG), 4-33 
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M4„SY3DEF DIALOG 

M4.SYSDEF DIALOG, 4-07 

44.SYSDEF DIALOG IN REBUILD MODE, 4-28 


MAP 

MAP, 5-32 
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MEDIA 

MOD 400/MFS PROGRAM MATERIALS AND DISTRIBUTION MEDIA, 7-0! 

MEMORY 

COMMUNICATIONS MEMORY REQUIREMENTS'(TBD, 6-12 
FORMULAS FOR CALCULATING FILE MEMORY SPACE (TBL), 5-54 
INCREMENTS FOR MEMORY POOLS'(TBL), 5-41 
LINKING MEMORY RESIDENT FUNCTION OBJECT UNITS, E-t2 
MEMORY ALLOCATION AND USAGE, 5-07 
MEMORY CONSIDERATIONS, £-1! 

MEMORY POOL DIRECTIVES, E-04 
MEMORY POOLS FOR LOGIN TASKS, L-01 
MEMORY REQUIREMENTS, N-02 

MEMORY REQUIREMENTS FOR MESSAGE FACILITY AND CHECKPOINT/RESTART - 
*(TBL), 5-56 

MEMORY REQUIREMENTS FOR SYSTEM CONTROL STRUCTJRES (TBL), 5-52 
MEMORY RESIDENT OBJECT UNIT LINKER DIRECTIVES (TBL), E-J2 
MEMORY SIZE, G-02 

MEMORY FRAGMENTATION 

MEMORY FRAGMENTATION, 5-08 

MEMPiXJL 

FORMULAS FOR CALCULATING FILE MEMORY SPACE (TBL), 5-50 
INCREMENTS FOR MEMORY POOLS (TBL), 5-4! 

MEMORY REQUIREMENTS FOR MESSAGE FACILITY AND CHECKPOINT/RESTART 
(TBL), 5-56 

MEMORY REQUIREMENTS FOR ELEMENTS IN ONLINE OR BATCH MEMORY POOLS 
(TBL), 5-54 

MEMORY REQUIREMENTS FOR SYSTEM CONTROL STRUCTURES (TBL), 5-52 
REQUIRED FOR SYSTEM COMPONENTS'(TBL), 5-46 

MESSAGE FACILITY ^ 

MEMORY REQUIREMENTS FOR MESSAGE FACILITY ANO CHECKPOINT/RESTART 
(TBL), 5-56 

MINIMUM SYSTEM 

MINIMUM SYSTEM FOR ONLINE APPLICATIONS (EXECUTE-ONLY) LAF MODE, C-02 
MINIMUM SYSTEM FOR ONLINE APPLICATIONS (EXECUTE-ONLY) SAF MODE, C-01 
MINIMUM SYSTEM FOR PROGRAM DEVELOPMENT, C-01 
MINIMUM SYSTEM GUIDELINES, C-01 

MODEL 23 

SUPPORTED HARDWARE - MODEL 23'(TBL), C-03 
MODEM 

MODEM, 6-47 
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OBJECT UNITS 

(SEE DATA ENTRY FACILITY-I) 

OPERATOR COMMAND 

CSD OPERATOR COMMAND IN START-UP.SC FILE FOR SYSTEM TASK 
GROUP, 6-01 

OkJPDATilD TPDMTNAT 

CONFIGURING 1 A DUAL-PURPOSE OPERATOR TERMINAL, 5-12 
CONFIGURING THE OPERATOR TERMINAL, 5-10 
OPERATOR TERMINAL CHARACTERISTICS. 5-10 
SYSTEM CONFIGURED WITHOUT OPERATOR TERMINAL, 5-15 
SYSTEM STARTUP TYPEOUT AT OPERATOR TERMINAL (FIG), 3-06 

OVERLAYS, SYSTEM 

(SEE SYSTEM OVERLAYS) 
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PERIPHERAL DEVICE 

IDENTIFYING PERIPHERAL DEVICE, 5-10 

POLIST 

POLIST, 6-50 

POWER RESUMPTION 

ACTIONS FOLLOWING POWER RESUMPTION, D-08 
CONFIGURING POWER RESUMPTION FACILITY. D-02 
POWER RESUMPTION, D-01 

POWER RESUMPTION CONFIGURATION REQUIREMENTS, 0-02 

PROGRAMMABLE FACILITY/3271 
CLM.USER FILE, K-0I 
CLM-USER FILE EXAMPLE, <-01 
COBOL INTERFACE PROGRAM, K-13 
DEVICE ADDRESSES, <-14 
DEVICE ADDRESSES (TSL), .<-14 
ERROR MESSAGES (T3L> , K-13 
EXAMPLES OF INITIALIZATION FILES, K-15 
INITIALIZATION FILE, K-05 
LEVEL I DIRECTIVES (TBL), K-07 
LEVEL 1 FUNCTIONALITY, K-05 
LEVEL 2 DIRECTIVES (T3L), K-IO 
LEVEL 2 FUNCTIONALITY, <-0* 

LOGIN TERMINALS FILE, K-02 

PROGRAM MATERIALS (SHCR4I) (FIG), 7-12 
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SUIT 

QUIT, 5—59 
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SBF/66 

(SEE REMOTE BATCH FACILITY/66) 


RCI 

DIRECTIVES APPLICABLE TO RCI* F-OI 
RCI, 6-54 

REBJILD MODE 

M4_SYS0EF DIALOG IN REBUILD MODE, 4-28 
REBJILD MODE DIALOG (TBL>, 4-30 
USING M4 SYSDEF IN REBUILD MODE, 4-04 
USING M4_SYSDEr IN REBUILD MODE, 4-47 

REMOTE BATCH FACILITY/68 

REMOTE BATCH fAClLXTY/66, F-04 
CONFIGURATION, F-0! 

CONFIGURATION DIRECTIVES, F-OI 
DIRECTIVES APPLICABLE TO RCI, F-OI 

EXAMPLE OF REMOTE BATCH CONFIGURATION DIRECTIVES, F-03 
* INITIALIZATION, F-03 

INVOKING THE RST TASK GROUP, r-07 
LDBU ZERRST, F-02 

MAKING INITIAL DEVICE ASSIGNMENTS, F-05 
MODIFYING EXTERNAL SNITCHES, F-06 
USING THE SH TASK GROUP, F-Q4 

RESIDENT CODE 

COMMUNICATIONS MEMORY REQUIREMENTS (T3L), 6-12 
REQUIRED FOR SYSTEM COMPONENTS <TSL), 5-46 
REQUIREMENTS FOR COMMUNICATIONS MODULES, 6-1 I 

RESOLA 

RESOLA, 5-6( 

RLOCK 

RLXK. 5-62 
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ROP, 6-56 


RPG 

RPG PROGRAM MATERIALS (SHL926) (FIG), 7-09 
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SEARCH RULES 

SYSTEM SEARCH RULES AND THE SYSTEM COMMAND, 8-04 
SOFTWARE 

PROCEDURE FOR TRANSFERRING SOFTWARE, 3-05 
SOFTWARE REQUIREMENTS, P-01 
SOFTWARE REQUIREMENTS, N-02 

SOFTWARE TO BE PLACED ON THE BOOTSTRAP VOLUME, 7-02 
SORT/MFRJE 

SDRT/MERGE PROGRAM MATERIALS CSHF910) (FIG). 7-10 
STAPOL 

STAPOL, 6-57 
START_UP.EC 

CSD OPERATOR COMMAND IN START_UP.SC FILE FOR SYSTEM TASK 
GROUP, 3-01 

DEr START_UP.EC FILE (TASK GENERATION), E-28 
SAMPLE START_UP.EC FILE (FIG), E-30 
SAMPLE START_UP.EC FILE, E—30 

STARTJP 

OPERATOR'S STARTUP ACTIONS, 3-t4 

OPERATOR STARTUP ACTIONS, £-34 

STAGE 2 STARTUP, 3-03 

STARTUP HALTS, A-OI 

SUMMARY OF STARTUP PROCEDURE, 3-10 

STATION 

STATION, 4-53 


STD 

STD, 6-59 
STDLN 

3TDLN, 6-6i 
STTY 

STTY, 6-65 

STTY COMMAND, D-03 


SYS 

SY S, 5-4 5 

SYS DECISION TABLE FOR CALCULATING TCB SIZE, BASED ON CPU 
MODEL AND SIP/CIP CHARACTERISTICS (T3D, 5-69 

SYSTEM BUILDING 

INTERACTIVE SYSTEM BUILDING PROGRAM, 4-01 

SYSTEM BUILDING, 1-02 

SYSTEM BUILDING OVERVIEW, t-01 
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SYSTEM EXTENSIONS 

SYSTEM EXTENSIONS, 5-07 

SYSTEM OVERLAYS 

SYSTEM OVERLAYS (TBL) • B-OI 
SYSTEM OVERLAYS, 5-06, B-0) 

SYSTEM STARTUP 

FLOWCHART OF SYSTEM STARTUP PROCESS (FIG), 3-11 

INITIAL SYSTEM STARTUP, 1-01 

SYSTEM STARTUP, 3-01 

SYSTEM STARTUP ACTIONS, 3-15 

SYSTEM STARTUP TYPEOUT AT OPERATOR TERMINAL (FIG), 3-06 
SYSTEM TASK CROUP 

CSD OPERATOR COMMAND IN START_UP.EC FILE FOR SYSTEM TASK GROUP, 9-01 
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TCLF 

TCLF PROGRAM MATERIALS (SHS94J) (FIG), 7-12 
TERMINAL 

COMMUNICATIONS TERMINALS STATE WITH LISTENER, L-09 
CONFIGURING AUTOMATIC TERMINAL RECONNECT, D-02 
NONCOMMUNICATIONS TERMINAL STATE WITH LISTENER, L-09 r " 
TERMINAL STATE AFTER LISTENER IS ACTIVATED, L-08 
TTY TERMINAL LINE SPEEDS (TBL), 3-06 

TERMINAL LINE LENGTH 

MINIFYING TERMINAL LINE LENGTH, 6-10 

TERMINAL LINE SPEED 

TERMINAL LINE SPEED SELECTION CAPABILITY (ASYNCHRONOUS TERMINALS 
ONLY), 6-10 
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TTY, 6-73 

TTY TERMINAL LINE SPEEDS (TBL), 3-06 
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VARIABLE, 5-71 
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